os.rename报“invalid cross-device link”是因底层rename(2)系统调用硬限制，源与目标必须在同一挂载点；跨磁盘、docker volume、wsl跨系统等均触发syscall.exdev错误，须捕获后降级为流式复制+删除并同步元数据。
os.Rename 为什么报 invalid cross-device link
这不是权限或路径写错，是操作系统硬限制：源和目标不在同一挂载点（比如 /tmp 和 /home 分属不同磁盘分区），os.Rename 底层调用的 rename(2) 系统调用根本无法跨设备。Docker volume 与宿主机路径混用、WSL 中 Windows 与 Linux 路径互移、NAS 挂载点与本地根目录之间移动，都会触发这个错误。
错误类型是 syscall.EXDEV（Linux/macOS）或类似设备错误（Windows），不能忽略。捕获方式必须用 errors.Is(err, syscall.EXDEV)，而不是字符串匹配 "invalid cross-device link"——后者不可靠且平台不一致。
- 别试图检查挂载点再预判：比对
Stat.Sys().(*syscall.Stat_t).Dev复杂且非必要，直接尝试 + 捕获更简单可靠 - 降级逻辑不是
ioutil.ReadFile→ioutil.WriteFile：大文件会 OOM，必须用os.Open→os.Create→io.Copy流式处理 - 复制成功后，记得调用
os.Chmod和os.Chtimes同步权限与时间戳，否则元数据丢失
目标路径已存在时行为完全不一致
os.Rename 不会自动覆盖，也不报统一错误。Linux/macOS 下可能静默覆盖空文件，Windows 几乎必然失败并返回 "file exists" 或 "Access is denied"。依赖“覆盖”语义会导致生产环境行为漂移。
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
正确做法是显式检查目标是否存在，并按需决策：
- 用
os.Stat(dst)判断：若os.IsNotExist(err)为 true，则可直接os.Rename - 若目标存在，不要直接
os.Remove(dst)再重命名——Remove也可能失败（只读、被占用、权限不足） - 需要自动避让（如
report.pdf→report_1.pdf）时，避免用循环 +os.Stat判定——并发下竞态导致多个 goroutine 同时认为report_1.pdf可用；改用os.OpenFile(dst, os.O_CREATE|os.O_EXCL|os.O_WRONLY)占位，利用O_EXCL的原子性确认名称可用
路径拼接和父目录缺失是最常翻车的两个点
手拼 "dir/" + filename 在 Windows 上生成 dir/\file.txt，直接触发 "The filename, directory name, or volume label syntax is incorrect."；os.Rename 也从不创建父目录，os.Rename("a.txt", "sub/b.txt") 必败，除非 sub/ 已存在。
- 所有路径拼接必须用
filepath.Join("data", "log.txt")，它自动适配分隔符并归一化..和重复斜杠 - 用户输入或配置生成的路径，必须先
filepath.Clean()再传给os.Rename，防止../etc/passwd类路径遍历 - 调用前务必
os.MkdirAll(filepath.Dir(dst), 0755)，尤其当目标含多级子目录时 - 关键操作建议统一转为绝对路径：
filepath.Abs(src)和filepath.Abs(dst)，避免相对路径受工作目录影响
Windows 下文件被占用时无绕过手段
目标文件正被记事本、VS Code 或其他进程打开时，os.Rename 在 Windows 上会卡在 "Access is denied"，这不是 Go 的问题，是 Windows 文件锁机制决定的。Linux 下虽宽松些，但若文件被 flock 或 fcntl 锁住，同样失败。
- 无法通过 Go 代码强制解除占用，唯一可行的是提示用户手动关闭进程
- 不要在
defer f.Close()后立即调用os.Rename：文件句柄未释放就重命名，在 Windows 上必败；业务逻辑结束后应显式f.Close()，再调用os.Rename - Windows 文件系统大小写不敏感，但
os.Rename是区分大小写的——os.Rename("A.txt", "a.txt")在 Windows 上会失败，需先os.Remove("a.txt")（如果存在）
os.Rename 就会以看似随机的方式失败。它快且原子，但绝不容错。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
