os.Rename是Go中移动和重命名文件的唯一标准操作，底层调用系统rename(2)，原子、高效；跨文件系统需手动copy+remove，并处理目录创建、权限、占用等隐式约束。
os.Rename 就是移动 + 重命名的唯一标准操作
Go 没有单独的 MoveFile 或 RenameFile 函数，os.Rename 就是你要用的全部——它既可重命名，也可跨目录移动，只要源和目标在同一个文件系统（即同一挂载点）。底层直接调用系统 rename(2) 系统调用，快、轻量、原子：不会出现“只移了一半”的中间状态。
-
os.Rename("a.txt", "b.txt")→ 同目录重命名 -
os.Rename("data/log.txt", "archive/log_2026.txt")→ 移动并改名（同盘） - 目标路径中的父目录（如
archive/）必须已存在，否则报no such file or directory - 目标路径若已存在，Windows 直接失败；Linux/macOS 行为不一致（可能覆盖空目录），切勿依赖
跨磁盘/分区失败？捕获 syscall.EXDEV 手动 copy+remove
当 os.Rename 返回 syscall.EXDEV（Linux/macOS）或类似设备错误（Windows 跨卷如 C:\ → D:\），说明源和目标不在同一挂载点。此时必须自己实现“复制内容 → 同步元数据 → 删除原文件”流程。
- 先用
os.Open和os.Create配合io.Copy复制内容 - 复制成功后，用
os.Chmod(dst, info.Mode())和os.Chtimes(dst, info.ModTime(), info.ModTime())同步权限与时间戳 - 最后
os.Remove(oldpath)；任一环
节失败，应保留原文件，并清理已写入的目标文件（避免残留）
- 别忘了提前用
os.MkdirAll(filepath.Dir(newpath), 0755)确保目标目录存在
常见踩坑点：路径、存在性、权限、占用
90% 的失败不是函数写错，而是环境没兜住。这些检查不能省：
- 源路径不存在 →
os.IsNotExist(err)，需提前os.Stat(oldpath)校验 - 目标父目录不存在 → 必须
os.MkdirAll(filepath.Dir(newpath), 0755)，不能指望os.Rename自动建 - Windows 下目标文件被编辑器/IDE 占用 → 报
Access is denied；可先os.Remove(newpath)（如果允许覆盖），或os.Chmod(newpath, 0666)解除只读 - 路径拼接别用
"dir" + "/" + "file.txt"，一律用filepath.Join("dir", "file.txt")防止 Windows/Linux 斜杠不一致
批量重命名要注意顺序和并发安全
遍历目录重命名多个文件时，边 os.ReadDir 边 os.Rename 很危险：比如把 1.txt → 2.txt，接着又把 2.txt → 3.txt，就丢了一个文件。
- 推荐做法：先用
os.ReadDir收集所有fs.DirEntry，生成完整的新路径列表，再统一执行os.Rename - 不需要并发加速 rename —— 它本身是系统调用，毫秒级；加 goroutine 反而增加出错排查难度
- 生产环境建议加 dry-run 模式：只打印将要执行的操作，确认无误再真实执行
- 若需按规则重命名（如添加前缀、补零编号），用
fmt.Sprintf生成新名，但注意filepath.Base和filepath.Ext提取扩展名更可靠
真正麻烦的从来不是 os.Rename 本身，而是它背后那套隐式约束：挂载点是否一致、目录是否存在、文件是否被锁、权限是否足够、路径是否合法。写一次 rename 很快，但让它在各种机器上都稳，得把每条错误分支都当成必经之路来对待。
