小程序开放平台

文档中心
暂无目录

fs.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)
}