小程序开放平台

文档中心
基础
转发
界面
网络
数据缓存
渲染
媒体
文件
getFileSystemManager
FileSystemManager
FileSystemManager方法
access
accessSync
copyFile
mkdirSync
readdir
rmdirSync
saveFile
saveFileSync
unlink
unzip
writeFile
writeFileSync
开放接口
设备
跳转
位置
支付

fs.writeFile

开发
>
JS API
>
文件
>
FileSystemManager方法
>
writeFile
>
更新时间:2025-07-23 11:41:03

📌 从基础库 3.125.4 版本开始支持

功能描述

写文件

参数

Object object

属性
类型
默认值
必填
说明
filePathstring目标文件路径(本地路径)
datastring/ArrayBuffer要写入的内容(文本或二进制)
encodingstringutf8字符编码(仅支持特定类型)
successfunction写入成功的回调
failfunction写入失败的回调
completefunction调用结束的回调

支持的编码类型

⚠️ 小红书平台仅支持以下编码

  • utf-8
    /
    utf8
  • binary

其他编码如ascii/hex/ucs2等不支持

错误码

示例代码

javascript
const fs = xhs.getFileSystemManager();

// 异步写入文本
fs.writeFile({
  filePath: `${xhs.env.USER_DATA_PATH}/log.txt`,
  data: "Hello 小红书",
  encoding: "utf8",
  success() {
    console.log("写入成功");
  },
  fail(res) {
    console.error("写入失败:", res.errMsg);
  }
});

// 同步接口
try {
  const res = fs.writeFileSync(
    `${xhs.env.USER_DATA_PATH}/hello.txt`,
    'some text or arrayBuffer',
    'utf8'
  )
  console.log(res)
} catch(e) {
  console.error(e)
}