os.Rename可用于文件或目录重命名及移动，要求同文件系统且目标路径不存在，否则报错；跨设备需结合复制和删除操作。
在 Go 语言中，使用 os.Rename 可以轻松实现文件或目录的重命名操作，也可以用于移动文件。这个函数属于标准库中的 os 包，使用时无需引入第三方依赖。
基本用法：os.Rename(oldpath, newpath)
os.Rename 接受两个参数：
- oldpath：原文件（或目录）路径
- newpath：目标路径（新文件名或新位置）
如果目标路径已存在，操作会失败并返回错误。成功则返回 nil。
示例代码：
立即学习“go语言免费学习笔记（深入）”；
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
package main
import (
"log"
"os"
)
func main() {
err := os.Rename("oldfile.txt", "newfile.txt")
if err != nil {
log.Fatal(err)
}
}
跨目录移动文件
os.Rename 不仅能重命名，还能将文件移动到另一个目录（前提是同个文件系统）。例如：
err := os.Rename("data/backup.log", "archive/backup_2025.log")
if err != nil {
log.Fatal(err)
}
这会把文件从 data 目录移到 archive 目录，并更改名称。
注意事项和常见问题
- 目标路径不能已存在，否则会报错：file exists
- 跨磁盘或不同文件系统重命名会失败，此时需要先复制再删除原文件
- 确保程序对源文件和目标目录有读写权限
- 重命名目录也适用该方法
可以先检查目标文件是否存在来避免错误：
if _, err := os.Stat("newfile.txt"); os.IsNotExist(err) {
err = os.Rename("oldfile.txt", "newfile.txt")
if err != nil {
log.Fatal(err)
}
} else {
log.Println("目标文件已存在")
}
总结
os.Rename 是 Golang 中最直接的文件重命名方式，适用于大多数本地文件操作场景。只要注意路径合法性、文件是否存在以及权限问题，就能安全使用。对于复杂情况（如跨设备移动），需结合 os.CopyFile 和 os.Remove 手动实现。
基本上就这些，不复杂但容易忽略细节。
