重命名文件

函数名：f_重命名 / f_Rename

功能描述

将指定文件重命名为新的文件名，文件所在目录保持不变。新文件名需包含扩展名。

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

语法

=f_重命名(原文件路径, 新文件名)

参数

参数名	类型	必填	默认值	说明
原文件路径	String	是	无	待重命名文件的完整路径
新文件名	String	是	无	新的文件名（需包含扩展名，如 report_new.pdf）

返回值

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

使用示例

文件重命名

公式：

=f_重命名("D:\Data\report_old.pdf", "report_new.pdf")

结果：

重命名成功

批量重命名（结合单元格引用）

公式：

=f_重命名(A1, B1)

结果：

重命名成功

（A1 为原文件路径，B1 为新文件名）

文件不存在

公式：

=f_重命名("C:\nofile.txt", "newname.txt")

结果：

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

技术说明

• 通过 Path.GetDirectoryName 提取原文件所在目录，再与 新文件名 拼接生成新完整路径。
• 调用 File.Move(oldPath, newPath) 实现文件重命名。
• 新文件名仅需文件名部分（含扩展名），无需包含目录路径，函数会自动保留原目录。
• 目标文件名若与同目录下已有文件重名，将触发异常。

错误处理

错误场景	返回值
原文件不存在	错误: 系统找不到指定的文件。
目标文件名已存在	错误: 文件已存在。
权限不足	错误: 拒绝访问。
其他异常	错误: {异常信息}