f_Move函数

函数名：wj_移动文件 / f_Move

函数功能

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

参数规范

参数名	类型	必填	示例	特殊说明
sourcePath	String	是	"C:\Temp\file1.txt"	要移动的文件的完整原路径
destPath	String	是	"D:\Docs\file2.txt"	文件的新路径（可包含新文件名）

使用案例

3.1 简单移动文件

问题描述：将文件从一个目录移动到另一个目录 公式演示：

=f_Move("C:\Temp\data.txt", "D:\Backup\data.txt")

输出效果：

移动成功

3.2 重命名文件

问题描述：修改文件名而不改变目录 公式演示：

=f_Move("D:\Backup\data.txt", "D:\Backup\data_2025.txt")

输出效果：

移动成功

3.3 移动失败错误提示

问题描述：移动不存在的文件或目标路径不可用 公式演示：

=f_Move("C:\Temp\nofile.txt", "D:\Backup\nofile.txt")

输出效果：

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

技术说明

4.1 移动操作说明

• 使用 File.Move 实现文件的移动与重命名
• 操作失败时返回异常消息，方便排查问题

4.2 异常处理

错误场景	返回值
源文件不存在	返回类似 错误: 找不到文件 '路径'
目标路径无效或权限不足	返回详细异常信息

扩展应用

6.1 文件归档

结合日期或其他标识，批量重命名或移动文件。

6.2 自动整理文件

通过脚本调用该函数实现文件自动分类移动。

注：本函数在WPS 2019+和Excel 365中测试通过