f_Copy函数

函数名：wj_复制文件 / f_Copy

函数功能

将指定的源文件复制到目标路径，支持选择是否覆盖已存在的同名文件。

参数规范

参数名	类型	必填	示例	特殊说明
sourcePath	String	是	"C:\Temp\file1.txt"	源文件的完整路径
destPath	String	是	"D:\Backup\file1.txt"	目标文件完整路径（包含文件名）
overwrite	Boolean	否	TRUE	是否覆盖目标路径中已存在的文件，默认 FALSE

使用案例

3.1 简单复制文件

问题描述：将文件从一个路径复制到另一个路径，不覆盖已有文件 公式演示：

=f_Copy("C:\Docs\report.docx", "D:\Backup\report.docx")

输出效果：

复制成功

3.2 覆盖复制

问题描述：复制文件并覆盖目标路径已存在的文件 公式演示：

=f_Copy("C:\Docs\report.docx", "D:\Backup\report.docx", TRUE)

输出效果：

复制成功

3.3 源文件不存在错误提示

问题描述：尝试复制不存在的源文件 公式演示：

=f_Copy("C:\Docs\notexist.txt", "D:\Backup\notexist.txt")

输出效果：

错误: 找不到文件 'C:\Docs\notexist.txt'。

技术说明

4.1 复制操作说明

• 采用 File.Copy 方法完成文件复制
• overwrite 参数控制是否覆盖同名目标文件
• 捕获异常并返回错误消息以便用户调试

4.2 异常处理

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

扩展应用

6.1 文件备份

=f_Copy("C:\Project\data.xlsx", "E:\Backup\data_backup.xlsx", TRUE)

自动覆盖备份文件，保持数据最新。

6.2 自动文件更新

结合条件判断，自动替换老版本文件。

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