移动文件或目录 (file.move)

声明​

操作成败, 错误信息 = file.move(源路径, 目标路径 [, 模式])

参数​

• 源路径 文本型，文件绝对路径
• 目标路径 文本型，文件绝对路径
• 模式 20250914+ 文本型，可选参数，移动模式。取值：
  • 空字符串或省略：默认模式（no-clobber），当目标已存在时返回失败
  • "overwrite" 或 "o"：覆盖模式，直接替换已存在的目标（已存在的目标会被删除）
  • "merge" 或 "m"：合并模式（仅用于目录），保留目标中已存在的文件
  • "overwrite-merge" 或 "om"/"mo"：覆盖合并模式，合并目录但覆盖同名文件

返回值​

• 操作成败 布尔型，操作成功返回 true，操作失败返回 false
• 错误信息 文本型，操作失败时的错误信息

说明​

移动一个文件或目录 源路径 到 目标路径

重命名文件 文件重命名 目录重命名 重命名目录 文件夹重命名 重命名文件夹 移动文件 文件移动 移动目录 目录移动 移动文件夹 文件夹移动

这个函数在 20250313 以后的版本方可使用

示例​

ok, err = file.move(NBT_SCRIPTS_PATH..'/1.zip', NBT_SCRIPTS_PATH..'/2.zip')
if not ok then
    sys.alert('移动失败：'..err)
end

注：上述代码中使用了非本章函数 sys.alert