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）

示例片段：

批量重命名与模式替换

对多个文件按规则重命名（如添加前缀、替换扩展名），可结合 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 删除原文件
• 整个过程非原子，需考虑失败回滚（如保留原文件、记录日志）

注意：目录跨设备重命名需递归处理，推荐使用第三方库如 github.com/otiai10/copy 简化逻辑。