f_Rename函数

函数名：wj_重命名 / f_Rename

函数功能

将指定文件重命名为新的文件名，保留文件所在目录不变。

参数规范

参数名	类型	必填	示例	特殊说明
oldPath	String	是	"C:\\Users\\user\\Documents\\file.txt"	原文件的完整路径
newName	String	是	"newfile.docx"	新的文件名，需包含扩展名

使用案例

3.1 文件重命名

问题描述：将文件重命名为新名称 公式演示：

=f_Rename("D:\\Data\\report_old.pdf", "report_new.pdf")

输出效果：

重命名成功

3.2 文件不存在或异常

问题描述：重命名不存在文件或无权限 公式演示：

=f_Rename("C:\\nofile.txt", "newname.txt")

输出效果（示例）：

错误: 系统找不到指定的文件。

技术说明

4.1 重命名逻辑

• 获取原文件目录路径
• 结合目录与新文件名生成新完整路径
• 调用 File.Move() 实现文件重命名

4.2 异常处理

错误场景	返回内容示例
文件不存在	"错误: 系统找不到指定的文件。"
权限不足	"错误: 拒绝访问。"
新文件名冲突	"错误: 目标文件已存在。"
其他异常	返回对应异常信息字符串

扩展应用

6.1 批量重命名示例

结合Excel拖动，快速修改一组文件名

6.2 重命名后读取确认

=IF(EXACT(FILENAME(A1), "新文件名.pdf"), "重命名成功", "未改名")

注：确保路径和新文件名合法，避免覆盖重要文件，操作前建议备份。