复制文件

函数名：f_复制文件 / f_Copy

功能描述

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

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

语法

=f_复制文件(源文件路径, 目标路径, 覆盖)

参数

参数名	类型	必填	默认值	说明
源文件路径	String	是	无	源文件的完整路径
目标路径	String	是	无	目标文件的完整路径（含文件名）
覆盖	Boolean	否	FALSE	TRUE=覆盖已存在的同名文件，FALSE=不覆盖（目标已存在时报错）

返回值

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

使用示例

复制文件（不覆盖）

公式：

=f_复制文件("C:\Docs\report.docx", "D:\Backup\report.docx")

结果：

复制成功

复制文件并覆盖已有文件

公式：

=f_复制文件("C:\Docs\report.docx", "D:\Backup\report.docx", TRUE)

结果：

复制成功

源文件不存在

公式：

=f_复制文件("C:\Docs\notexist.txt", "D:\Backup\notexist.txt")

结果：

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

技术说明

• 调用 File.Copy(sourcePath, destPath, overwrite) 完成文件复制。
• 覆盖 参数直接传递给 File.Copy 的 overwrite 参数，控制是否覆盖同名目标文件。
• 目标路径的父目录必须已存在，否则会触发异常。

错误处理

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