Go 中重命名或移动文件统一用 os.Rename,同磁盘原子操作,跨磁盘需 copy+remove;要求路径完整、目标不存在、父目录存在,且须检查错误。

在 Go 语言中,重命名文件(或移动文件)统一使用 os.Rename 函数,它既可以改名,也能跨目录移动,但跨磁盘时会失败。
基本用法:重命名同一目录下的文件
os.Rename 接收两个参数:源路径(oldpath)和目标路径(newpath),成功返回 nil,出错返回 error。注意路径必须是完整路径(相对或绝对均可),且目标路径不能已存在(Windows 下尤其严格)。
示例:
err := os.Rename("old.txt", "new.txt")
if err != nil {
log.Fatal(err)
}
移动文件到其他目录
只要源和目标在同一磁盘/文件系统,os.Rename 也支持移动。目标路径可包含目录层级,但父目录必须已存在,否则报错 no such file or directory。
立即学习“go语言免费学习笔记(深入)”;
建议操作顺序:
- 用
os.Stat或os.IsNotExist检查源文件是否存在 - 用
os.MkdirAll确保目标目录存在(如果需要创建) - 再调用
os.Rename
跨磁盘/分区重命名会失败
Linux/macOS 下,os.Rename 底层调用系统 rename(2) 系统调用,不支持跨设备(即不同挂载点)。Windows 同样限制跨卷(如 C:\ → D:\)。此时需手动复制+删除:
- 用
io.Copy复制内容到新路径 - 用
os.Remove删除原文件 - 注意处理中间失败:复制成功后删源失败,需保留原文件并清理临时副本
常见错误与注意事项
容易忽略的细节:
- 目标路径已存在时,Windows 直接报错;Linux/macOS 若目标是空目录则可能成功覆盖(行为不一致,不建议依赖)
- 路径含中文或特殊字符时,确保字符串编码正确(Go 字符串默认 UTF-8,通常没问题)
- 权限不足、路径过长、进程占用文件等都会导致失败,务必检查
err - 重命名不是原子操作?其实是——只要在同一文件系统,
os.Rename是原子的,不会出现“半重命名”状态
基本上就这些。记住核心原则:同盘 rename,跨盘 copy+remove,始终检查错误。










