答案:go中文件重命名主要使用os.Rename(),它是原子操作,支持同目录改名和跨目录移动,但跨文件系统时需手动实现复制删除逻辑。

在 Go 语言中,文件重命名用 os.Rename() 就能完成,它本质是原子操作,既支持同目录改名,也支持跨目录移动(前提是目标路径在同一文件系统上)。
基本用法:用 os.Rename() 一步到位
Go 标准库没有单独的“重命名”函数,os.Rename(oldName, newName) 就是标准方案。它底层调用系统 rename(2) 系统调用,速度快、原子性强。
- 如果
newName已存在,windows 下会报错;linux/macOS 默认覆盖(行为取决于系统,Go 不做额外封装) - 跨分区(不同挂载点)时会失败,返回
syscall.EXDEV错误,需手动实现“复制+删除”逻辑 - 路径可为相对或绝对,但建议统一用绝对路径,避免工作目录影响
安全重命名:检查目标是否存在
若希望“不覆盖已有文件”,需提前检查目标路径:
- 用
os.Stat(newName)判断文件是否存在(注意:目录也算存在) - 若存在,可返回错误、自动加后缀(如
file_1.txt),或由调用方决定策略 - 示例:重命名前加校验
_, err := os.Stat(“target.txt”)
if err == nil {
// 文件已存在,拒绝重命名
return errors.New(“target already exists”)
}
跨文件系统重命名:手动复制 + 删除
当 os.Rename() 返回 syscall.EXDEV(或更通用的 errors.Is(err, syscall.EXDEV)),说明需“软重命名”:
立即学习“go语言免费学习笔记(深入)”;
- 先用
io.copy()复制源文件到新路径 - 再用
os.Chmod()和os.Chtimes()同步权限与时间戳 - 最后用
os.Remove()删除原文件 - 任一环节失败,应清理中间状态(比如删掉已写入的目标文件)
实用小技巧
- 路径拼接别用字符串加号,用
filepath.Join("dir", "file.txt")更健壮 - 重命名前确保源文件可读、目标目录可写,否则提前报错比执行一半失败更友好
- 批量重命名建议加日志或 dry-run 模式,防止误操作
基本上就这些。核心就是 os.Rename(),其余都是围绕它做容错和兼容。