移动文件

函数名：f_移动文件 / f_Move

功能描述

将指定的文件从原路径移动到新路径，可用于文件移动或重命名操作。

会员等级：🟢 免费版（Free）

语法

=f_移动文件(原路径, 新路径)

参数

参数名	类型	必填	默认值	说明
原路径	String	是	无	要移动的文件的完整原路径
新路径	String	是	无	文件的新路径（可包含新文件名）

返回值

String - 操作结果字符串。成功返回 "移动成功"，异常返回 "错误: {异常信息}"。

使用示例

跨目录移动文件

公式：

=f_移动文件("C:\Temp\data.txt", "D:\Backup\data.txt")

结果：

移动成功

同目录重命名文件

公式：

=f_移动文件("D:\Backup\data.txt", "D:\Backup\data_2025.txt")

结果：

移动成功

源文件不存在

公式：

=f_移动文件("C:\Temp\nofile.txt", "D:\Backup\nofile.txt")

结果：

错误: 找不到文件 'C:\Temp\nofile.txt'。

技术说明

• 调用 File.Move(sourcePath, destPath) 实现文件的移动与重命名。
• File.Move 是原子操作，在同一卷内移动仅修改目录条目，速度极快。
• 目标路径的父目录必须已存在，否则会触发异常。
• 目标文件若已存在会触发异常（.NET Framework 版本不支持覆盖）。

错误处理

错误场景	返回值
源文件不存在	错误: 找不到文件 '{路径}'。
目标文件已存在	错误: 文件已存在。
目标路径无效或权限不足	错误: {具体异常信息}