os.rename失败主因是跨设备移动、父目录不存在、权限不足或覆盖非空目录；跨设备需手动copy+remove，重命名前须用os.mkdirall确保目标父目录存在，windows大小写处理需额外校验。
os.Rename 会失败的典型错误信息
直接调用 os.Rename 却报 invalid cross-device link，不是代码写错了，是源和目标路径在不同文件系统上（比如从 /tmp 移到 /home，而它们挂载在不同磁盘或分区）。这个错误在 Linux/macOS 常见，Windows 上少见但并非完全免疫（例如 NTFS 和 ReFS 间）。
其他高频失败原因：
-
no such file or directory：源路径不存在，或目标父目录不存在（os.Rename不自动创建中间目录） -
permission denied：对源目录或目标目录缺少执行（x）权限（Linux/macOS 下访问目录需要x） -
directory not empty：尝试用os.Rename覆盖非空目录（它不递归删除）
跨设备移动必须手动 copy + remove
os.Rename 本质是系统调用 rename(2)，仅支持同设备原子重命名。跨设备时得自己实现“复制后删源”。别手写递归 copy —— 用 io.Copy 处理文件，用 filepath.Walk 遍历目录结构，但更稳妥的是依赖 golang.org/x/exp/io/fs（Go 1.22+）或社区成熟封装如 github.com/anacrolix/torrent/fsutil 的 CopyDir；不过最轻量做法仍是分三步：
- 用
os.Stat检查源是否为文件还是目录 - 若是文件：打开源、创建目标父目录（
os.MkdirAll）、io.Copy写入、os.Remove删除源 - 若是目录：先
os.MkdirAll创建目标路径，再遍历复制每个条目，最后递归os.RemoveAll源目录
注意：复制过程中若出错，要记得清理已写入的目标，否则留下脏数据。
立即学习“go语言免费学习笔记（深入）”；
重命名前必须确保目标父目录存在
os.Rename("a.txt", "sub/b.txt") 会失败，除非 sub/ 已存在。它不负责创建任何中间路径 —— 这点和 shell 的 mv 行为不同，容易被忽略。
正确做法总是提前处理：
- 提取目标路径的父目录：
filepath.Dir("sub/b.txt") - 调用
os.MkdirAll创建它，忽略os.IsExist错误 - 再执行
os.Rename
示例片段：
dstDir := filepath.Dir(dstPath)
if err := os.MkdirAll(dstDir, 0755); err != nil {
return err
}
return os.Rename(srcPath, dstPath)
Windows 下大小写重命名需额外处理
在 Windows 上，NTFS 默认不区分大小写，所以 os.Rename("FILE.TXT", "file.txt") 可能静默成功，也可能失败（取决于卷是否启用区分大小写标志）。但更常见的是：你本意是改名，结果因大小写差异被当成“同一文件”，导致后续读取逻辑混乱。
安全做法是先检查目标是否已存在且内容相同（用 os.Stat + 文件大小/修改时间粗判），或强制走 copy + remove 流程；如果只是想统一小写，建议先 os.ReadDir 列出当前目录，比对名称是否已存在对应变体，避免意外覆盖。
真正难搞的是：某些 CI 环境跑在 Linux 容器里测试 Windows 路径逻辑 —— 这时候大小写敏感性会彻底反转，必须在测试中显式覆盖该分支。
路径操作永远比看起来复杂，尤其是涉及跨平台、跨设备、大小写、符号链接时，os.Rename 只是原子操作的快捷方式，不是万能搬运工。
