# FileSystemManager.appendFile(Object object)

在文件末尾异步追加内容。若文件不存在则自动创建。

# 支持情况

项 说明
兼容性 兼容微信

# 语法

const fs = mt.getFileSystemManager()
fs.appendFile({ filePath, data, encoding, success, fail, complete })

# 参数

Object object

属性 类型 默认值 必填 说明
filePath string — 是 要追加内容的文件路径
data string | ArrayBuffer — 是 要追加的内容
encoding string 'utf8' 否 指定写入文件的字符编码,当 data 为 string 时有效,可选值见下表
success function — 否 成功回调
fail function — 否 失败回调
complete function — 否 完成回调(成功或失败均触发)

encoding 合法值

值 说明
ascii
base64
binary
hex
ucs2 / ucs-2 / utf16le / utf-16le
utf8 / utf-8
latin1

# 返回值

无返回值。

# 示例代码

const fs = mt.getFileSystemManager()
fs.appendFile({
  filePath: `${mt.env.USER_DATA_PATH}/log.txt`,
  data: 'new line\n',
  encoding: 'utf8',
  success() {
    console.log('追加成功')
  },
  fail(err) {
    console.error(err.errMsg)
  }
})

# 与微信差异

无差异(行为与微信小游戏一致)。

上次更新: 8/10/2026, 5:36:37 PM