os.Rename仅在同一文件系统内原子生效，跨分区、挂载点、Docker volume或WSL路径时必报“invalid cross-device link”错误；需用errors.Is(err, syscall.EXDEV)捕获后降级为复制+删除，并同步权限、时间戳，最后安全删除源文件。
os.Rename 不是万能的重命名函数，它只在**同一文件系统内原子生效**；跨分区、跨挂载点、跨 Docker volume 或 WSL 路径时必然失败，错误信息是 invalid cross-device link，对应底层 syscall.EXDEV。别查权限或路径拼写——先检查是否跨设备。
os.Rename 失败时如何判断是跨设备问题
错误不是 permission denied 或 no such file or directory，而是明确返回字符串包含 "invalid cross-device link"，或用 errors.Is(err, syscall.EXDEV) 可靠识别（Linux/macOS）。Windows 上可能表现为 The system cannot move the file to a different disk drive，本质相同。
- 用
df -P /path/to/old和df -P /path/to/new对比 Filesystem 列是否一致 - Docker 容器中：宿主机
/host/data与容器内/tmp几乎总是不同设备 - WSL2 中：
/mnt/c/xxx和/home/xxx属于不同文件系统，直接os.Rename必挂 - 不要依赖
os.IsNotExist或os.IsPermission做兜底判断——先os.Stat源路径，再调用，出错后立刻用errors.Is(err, syscall.EXDEV)分流
跨设备时必须手动实现 copy + remove
不能跳过中间状态，必须确保内容落盘、元数据同步、原文件安全删除。否则可能丢数据或留脏文件。
- 用
os.Open读源文件，os.Create写目标（或更安全地用os.CreateTemp(filepath.Dir(newpath), "tmp-*")） - 复制完必须调用
dstFile.Sync()（非os.Sync()），再dstFile.Close() - 用
os.Stat(oldpath)获取原始os.FileInfo，再调用os.Chmod(newpath, info.Mode())和os.Chtimes(newpath, info.ModTime(), info.ModTime()) - 仅当全部成功后，才调用
os.Remove(oldpath)；任一环节失败，应os.Remove(newpath)清理残留，并保留原文件
目标路径已存在时的行为不统一，必须主动处理
Windows 下 os.Rename 默认拒绝覆盖，Linux/macOS 行为依赖内核和文件系统，Go 不做封装也不保证一致性。生产代码里不能假设“会覆盖”或“会报错”。
立即学习“go语言免费学习笔记（深入）”；
- 调用前用
os.Stat(newpath)检查目标是否存在，而非依赖os.IsExist(err)（该函数已被标记为 deprecated） - 若目标存在且是普通文件，按需决定：跳过、备份（
os.Rename(newpath, newpath+".bak")）、或先os.Remove(newpath) - 若目标是目录而源是文件，
os.Rename必然失败，此时不应尝试降级 copy，而应直接报错或拒绝操作 - Windows 上目标被占用（如记事本打开）会报
Access is denied，可先os.Remove(newpath)尝试释放，但注意这会产生短暂的“文件不存在”窗口
中文路径、相对路径、并发场景的隐性陷阱
看似简单的字符串传参，实际藏着三类高频崩溃点：编码错乱、路径不规范、竞态冲突。
- 所有外部输入路径（HTTP query、JSON、命令行 flag）必须先
url.PathUnescape（若来自 URL）或确保 UTF-8 合法；调试时用fmt.Printf("%q", path)查看字节，别信fmt.Println - 路径拼接一律用
filepath.Join("dir", "file.txt")，禁用"dir/" + "file.txt"；创建父目录用os.MkdirAll(filepath.Dir(newpath), 0755)，不能指望os.Rename自动建 - 批量重命名时，禁止边
os.ReadDir边os.Rename：例如把1.txt → 2.txt，紧接着又2.txt → 3.txt，第一个2.txt就丢了；正确做法是先收集全量fs.DirEntry和新路径映射，再单协程顺序执行
最常被忽略的点：临时文件必须和目标文件在同一挂载点。日志轮转或配置热更新时，如果把 os.CreateTemp("/tmp", "*.tmp") 的临时文件 os.Rename 到 /data/config.json，只要 /tmp 和 /data 不是同一文件系统，就一定会失败——这个约束不是 Go 设计缺陷，而是 POSIX rename(2) 的硬性要求。
