# FileSystemManager.rename(Object object)

异步重命名文件或目录,也可用于移动文件。

# 支持情况

项 说明
兼容性 兼容微信

# 语法

const fs = mt.getFileSystemManager()
fs.rename({ oldPath, newPath, success, fail, complete })

# 参数

Object object

属性 类型 默认值 必填 说明
oldPath string — 是 源文件/目录路径
newPath string — 是 目标文件/目录路径
success function — 否 成功回调
fail function — 否 失败回调
complete function — 否 完成回调(成功或失败均触发)

# 返回值

无返回值。

# 示例代码

const fs = mt.getFileSystemManager()
fs.rename({
  oldPath: `${mt.env.USER_DATA_PATH}/a.txt`,
  newPath: `${mt.env.USER_DATA_PATH}/b.txt`,
  success() {
    console.log('重命名成功')
  },
  fail(err) {
    console.error(err.errMsg)
  }
})

# 与微信差异

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

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