os.Rename可原子重命名同文件系统内的文件或目录，需确保源存在、目标父目录存在，跨设备时需复制后删除。
使用 go 的 os.Rename 可以快速、原子地重命名文件或目录，它底层调用操作系统对应的 rename 系统调用，效率高且在同文件系统内是原子操作。
基本用法：重命名单个文件
os.Rename 接收两个参数：源路径（oldpath）和目标路径（newpath），均为字符串。若目标路径已存在，windows 下会报错，linux/macOS 下会覆盖（取决于系统行为，但 Go 标准库不保证跨平台覆盖语义，应避免依赖）。
- 确保源文件存在，否则返回
os.ErrNotExist - 目标路径的父目录必须存在，否则返回
os.ErrNotExist（如将a.txt重命名为sub/b.txt，需先确保sub/目录存在） - 路径支持相对路径和绝对路径，建议统一用
filepath.Clean或filepath.Abs规范化
安全重命名：检查与错误处理
生产代码中不应直接调用 os.Rename 后忽略错误。常见健壮写法包括：
- 调用前用
os.Stat检查源文件是否存在且为普通文件 - 检查目标路径是否已存在，按需决定是否跳过、备份或报错
- 捕获并区分常见错误，例如：
os.ErrNotExist、os.ErrPermission、syscall.EXDEV（跨设备移动，此时需 copy + remove）
示例片段：
立即学习“go语言免费学习笔记（深入）”；
if err := os.Rename(“old.txt”, “new.txt”); err != nil {
if errors.Is(err, os.ErrNotExist) {
log.Println(“源文件不存在”)
} else if errors.Is(err, syscall.EXDEV) {
log.Println(“无法跨文件系统重命名，需复制后删除”)
} else {
log.Fatal(err)
}
}
批量重命名与模式替换
对多个文件按规则重命名（如添加前缀、替换扩展名），可结合 filepath.Walk 或 os.ReadDir 遍历，再逐个调用 os.Rename：
- 注意遍历时路径拼接使用
filepath.Join，避免手动拼接斜杠问题 - 若需按顺序重命名（如编号 1.txt → 001.txt），建议先收集所有待处理文件，生成新名，再执行；避免边遍历边重命名导致路径错乱
- 对同一目录下大量文件操作，可考虑加锁或限制并发（通常单协程足够，rename 本身很快）
跨文件系统重命名的替代方案
当 os.Rename 返回 syscall.EXDEV（Linux/macos）或类似错误（windows 上可能为权限/设备错误），说明源和目标不在同一挂载点，此时需手动实现“复制 + 删除”：
- 用
os.Open和os.Create配合io.Copy复制内容 - 复制成功后，用
os.Remove删除原文件 - 整个过程非原子，需考虑失败回滚（如保留原文件、记录日志）