更新记录

1.0.1（2026-07-01）

新增

• getFileInfo：获取文件信息，返回文件名称、大小、MIME 类型、创建时间、修改时间
• Android 平台支持 content:// 协议和普通文件路径

1.0.0（2026-07-01）

新增

• 初始版本发布
• 支持 Android、iOS 平台
• access：判断文件/目录是否存在
• copyFile：复制文件（支持 content:// 协议）
• mkdir：创建目录（支持递归创建）
• readFile：读取文件内容（支持 base64 / utf-8 / ascii 编码，不传则返回 ArrayBuffer）
• remove：递归删除目录或单个文件
• readdir：读取目录内文件列表
• rename：重命名文件/目录（支持移动）
• getSandboxPath / getCachePath / getUserDataPath：获取应用目录路径

平台兼容性

uni-app(5.07)

uni-app x(5.07)

cc-fs

文件系统操作 UTS API 插件，支持 Android、iOS。

功能特性

• ✅ access：判断文件/目录是否存在
• ✅ copyFile：复制文件（支持 content:// 协议）
• ✅ mkdir：创建目录（支持递归创建）
• ✅ readFile：读取文件内容（支持 base64 / utf-8 / ascii 编码，不传则返回 ArrayBuffer）
• ✅ remove：递归删除目录或单个文件
• ✅ readdir：读取目录内文件列表
• ✅ rename：重命名文件/目录（支持移动）

使用方法

import { access, copyFile, mkdir, readFile, remove, readdir, rename, getSandboxPath, getCachePath, getUserDataPath } from "@/uni_modules/cc-fs";

目录获取方法

access

判断文件或目录是否存在。

access({
  path: "/path/to/file.txt",
  success(res) {
    console.log(res.exists); // true / false
  }
});

参数

success 回调参数

copyFile

复制文件（支持 content:// 协议）。

copyFile({
  srcPath: "/path/to/source.txt",
  destPath: "/path/to/dest.txt",
  success(res) {
    console.log("复制成功");
  }
});

参数

success 回调参数

mkdir

创建目录。

mkdir({
  path: "/path/to/new/dir",
  recursive: true, // 是否递归创建，默认 false
  success(res) {
    console.log("创建成功");
  }
});

参数

success 回调参数

readFile

读取本地文件内容。

// 以 utf-8 编码读取文本文件
readFile({
  path: "/path/to/file.txt",
  encoding: "utf-8",
  success(res) {
    console.log(res.data); // string
  }
});

// 以 ArrayBuffer 格式读取二进制文件
readFile({
  path: "/path/to/file.bin",
  success(res) {
    console.log(res.data); // ArrayBuffer
  }
});

参数

success 回调参数

remove

递归删除目录或单个文件。

remove({
  path: "/path/to/file-or-dir",
  success(res) {
    console.log("删除成功");
  }
});

参数

success 回调参数

readdir

读取目录内文件列表。

readdir({
  path: "/path/to/dir",
  success(res) {
    console.log(res.files); // ReaddirItem[]
    res.files.forEach(item => {
      console.log(item.name, item.isDirectory, item.size);
    });
  }
});

参数

success 回调参数

ReaddirItem

rename

重命名文件/目录，可将文件从 oldPath 移动到 newPath。

rename({
  oldPath: "/path/to/old.txt",
  newPath: "/path/to/new.txt",
  success(res) {
    console.log("重命名成功");
  }
});

参数

success 回调参数

错误码