Go 中 os.Rename 不保证跨文件系统移动，遇 EXDEV 错误需降级为复制+删除；目录移动须用 filepath.Join 拼接路径；大文件应流式复制并校验大小；权限与时间戳需手动设置。
Go 中没有直接的 os.Rename 跨文件系统移动保证
很多人以为 os.Rename 就是“移动文件”，但实际它底层调用的是系统 rename(2) 系统调用——该调用仅在**同一文件系统内**才真正原子移动；跨分区（如从 /tmp 到 /home）时会失败并返回 invalid cross-device link 错误。
所以不能无条件信任 os.Rename 的返回值就认为移动成功。真实项目中必须判断错误类型，再降级为“复制 + 删除”逻辑。
- 检查错误是否为
syscall.EXDEV（Linux/macOS）或ERROR_NOT_SAME_DEVICE（Windows） - 跨设备时手动
io.Copy源到目标，再os.Remove源文件 - 注意：复制过程中若中断，需清理残留的目标临时文件
用 filepath.Walk 移动整个目录时要小心路径拼接
移动目录不是简单调用 os.Rename 一次就能完成——如果目标路径已存在同名子目录，os.Rename 会直接失败（而非合并）。更常见的是想把 /a/b/c “整体移入” /x/y 变成 /x/y/c，这时必须自己拼好目标路径。
关键点在于：不要硬编码 "/" 拼接，要用 filepath.Join 处理不同操作系统的路径分隔符。
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 源路径
src := "/a/b/c"，目标父目录dstParent := "/x/y" - 正确拼接：
dst := filepath.Join(dstParent, filepath.Base(src)) - 错误写法：
dst := dstParent + "/" + filepath.Base(src)（Windows 下出错） - 若需递归移动整个树，先
os.MkdirAll目标路径，再遍历源目录逐个复制+删除
移动大文件时避免内存爆满：用 io.Copy 配合 os.OpenFile 的 os.O_CREATE | os.O_WRONLY
跨设备移动大文件（如几百 MB 视频）时，别用 ioutil.ReadFile + ioutil.WriteFile——这会一次性把全部内容读进内存，极易 OOM。
应使用流式复制，并显式控制 buffer 大小（默认 io.Copy 用 32KB，通常足够）：
srcF, _ := os.Open(srcPath) defer srcF.Close() dstF, _ := os.OpenFile(dstPath, os.O_CREATE|os.O_WRONLY|os.O_TRUNC, 0644) defer dstF.Close() io.Copy(dstF, srcF) // 内部按 chunk 流式读写
- 务必用
os.O_TRUNC，否则追加写入会导致文件内容错乱 - 复制完成后，再
os.Remove(srcPath)；若删除失败，应记录警告但不中断流程（避免“半移动”状态丢失源文件） - 可选：复制前用
os.Stat校验源文件大小，复制后再次校验目标文件大小是否一致
权限与元数据不会自动继承，需要手动处理
os.Rename 和 io.Copy 都不会保留原文件的权限、所有者、atime/mtime 等元数据。多数场景下这不是问题，但若用于备份、归档或严格合规系统，则必须补全。
Linux/macOS 上可用 os.Chmod、os.Chtimes；Windows 不支持 atime/mtime 精确设置（仅能设 mtime），且所有权需调用 syscall。
- 复制后立即获取源文件 info：
fi, _ := srcF.Stat() - 设置权限：
os.Chmod(dstPath, fi.Mode()) - 设置时间：
os.Chtimes(dstPath, fi.ModTime(), fi.ModTime())（atime 通常忽略） - 注意：
fi.Mode()包含权限位，但不含 setuid/setgid；如需保留，得用syscall或外部工具（如cp -p）
跨平台元数据一致性是最容易被跳过的环节，尤其在 CI/CD 自动化脚本里——一旦依赖文件权限做安全校验，这里出错就很难排查。
