os.rename是go中重命名和移动文件的唯一标准操作，仅在同一文件系统内原子生效；跨设备时因底层rename(2)限制报“invalid cross-device link”错误，须捕获syscall.exdev后降级为复制+删除，并手动处理权限、时间戳及父目录。
os.Rename 是 Go 中重命名和移动文件的唯一标准操作，但它只在**同一文件系统内原子生效**；跨磁盘、跨分区、跨挂载点时必然失败，必须手动降级为「复制 + 删除」流程。
为什么 os.Rename 会报 invalid cross-device link
这不是权限或路径写错，而是底层 rename(2) 系统调用的硬限制：它不允许源和目标位于不同设备（比如 /tmp 和 /home 分属两个磁盘分区，Docker volume 挂载点与宿主机路径不一致，WSL 中 Windows 和 Linux 路径混用）。Go 将该错误转为字符串 "invalid cross-device link"，实际对应 syscall.EXDEV 错误类型。
常见误判场景：
- 在 Docker 容器里把文件从
/tmp移到挂载的/data卷 → 失败 - WSL2 中尝试
os.Rename("/mnt/c/file.txt", "/home/user/file.txt")→ 失败 - NAS 挂载目录与本地根目录之间移动 → 失败
别费劲检查挂载点——直接捕获错误更可靠：
err := os.Rename(src, dst)
if err != nil {
var linkErr *os.LinkError
if errors.As(err, &linkErr) && errors.Is(linkErr.Err, syscall.EXDEV) {
// 降级为 copy + remove
}
}
目标路径已存在时行为不一致，必须显式控制
os.Rename 在目标路径已存在时，Linux/macOS 可能覆盖（取决于内核版本和文件类型），Windows 则几乎总是报 file exists 或 Access is denied。Go 标准库不承诺跨平台覆盖语义，所以不能依赖。
安全做法是提前检查并按需处理：
- 用
os.Stat(dst)判断目标是否存在 - 若存在且是普通文件，可先
os.Remove(dst)（注意检查os.IsPermission） - 若目标是目录，
os.Rename必然失败，应拒绝或转为递归复制逻辑 - 避免边
os.ReadDir边重命名——例如把1.txt → 2.txt后又把2.txt → 3.txt，会丢数据
路径拼接和父目录必须手动处理
os.Rename 不创建父目录，也不解析相对路径。写成 "log/" + "app.log" 在 Windows 上可能生成非法路径 log/\app.log，导致 "The filename, directory name, or volume label syntax is incorrect."。
正确姿势：
- 一律用
filepath.Join("log", "app.log")拼接 - 重命名前调用
os.MkdirAll(filepath.Dir(dst), 0755)确保父目录存在 - 用户输入或配置来的路径，先过一遍
filepath.Clean()防止../etc/passwd类路径遍历 - 不要用
filepath.Dir(dst)的结果直接os.MkdirAll——它可能返回空字符串（如 dst 是"file.txt"），需兜底判断
大文件、中文路径、已打开文件的实操要点
这些不是边缘情况，而是线上高频踩坑点：
- 大文件别用
ioutil.ReadFile→ 内存爆掉；改用os.Open→os.Create→io.Copy流式复制 - 中文路径本身没问题（Go 原生 UTF-8 支持），但若从 URL 或命令行来，必须先
url.PathUnescape或确保终端编码一致；调试时用fmt.Printf("%q", path)看真实字节 - 文件被其他进程占用（如 Windows 下被记事本/IDE 打开）→
os.Rename直接失败，无法绕过；业务中若需先读写再重命名，务必显式file.Close()，别靠defer（否则重命名时句柄仍被占） - 复制后要同步元数据：
os.Chmod(dst, srcInfo.Mode())和os.Chtimes(dst, srcInfo.ModTime(), srcInfo.ModTime())，否则权限和修改时间全丢
os.Rename，而是在各种挂载组合、权限模型、并发时机和路径来源下，让“移动”这件事不丢数据、不崩权限、不卡死进程。每次调用前，都要问自己：源存在吗？目标父目录存在吗？目标是否已被占用？跨设备了吗？错误有没有被正确分类处理？golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
