os.rename不能跨文件系统移动文件，因仅封装rename(2)系统调用；目标存在时不覆盖，需手动检查删除；中文路径须正确解码；并发重命名需外部同步机制。
os.Rename 不能跨文件系统移动文件
os.Rename 看似万能，实际只做底层 rename(2) 系统调用——这意味着它要求源路径和目标路径必须在同一个挂载点（同一文件系统）上。一旦跨分区、跨磁盘、或目标在 NFS/overlayfs 等特殊文件系统上，就会直接报错：invalid cross-device link。
常见场景：把 /tmp/file.txt 重命名到 /home/user/file.txt，但 /tmp 和 /home 实际是不同挂载分区；Docker 容器内挂载的 host 路径也常触发此问题。
解决办法不是硬扛，而是主动降级为「复制 + 删除」：
- 先用
io.Copy或os.ReadFile+os.WriteFile把内容写入新路径 - 再用
os.Remove删除原文件（注意：要确保写入成功后再删） - 记得检查每一步的 error，尤其是写入后
os.Sync或file.Close()的返回值，避免缓存未落盘就删源文件
重命名时目标路径已存在会失败
os.Rename 在大多数操作系统上不支持覆盖。如果目标路径已存在（无论文件还是目录），它会直接返回 file exists 错误（Linux）或类似 The system cannot move the file to a different disk drive（Windows 上有时误报，实为存在冲突）。
这不是 bug，是设计使然。你要覆盖，就得自己处理：
- 用
os.Stat检查目标是否存在 - 若存在且是普通文件，先
os.Remove目标（注意权限和是否只读） - 若目标是目录而源是文件，
os.Rename必然失败，此时必须拒绝或转为复制逻辑 - 别依赖
os.IsExist(err)判断——某些错误（如权限不足）也可能被误判，应先os.Stat再决策
路径中含中文或特殊字符需注意编码与转义
Go 的 os.Rename 本身对 UTF-8 路径完全友好，但坑往往出在上游：比如从 HTTP query、命令行参数、配置文件读取路径时，没做正确解码，导致传入的是乱码或双重编码字符串。
典型现象：os.Rename("a.txt", "测试.txt") 在 macOS/Linux 正常，但在 Windows 控制台下可能因终端编码不一致变成 娴ュ??.txt；或者从 URL 中取路径忘了 url.PathUnescape。
实操建议：
- 所有外部输入的路径，统一用
filepath.Clean规范化（处理../、重复/等） - 如果是 URL 来源，务必先
url.PathUnescape；如果是 JSON 字段，确保 Go 解码后字符串已是合法 UTF-8 - 调试时用
fmt.Printf("%q", path)查看实际字节，比fmt.Println(path)更可靠
并发重命名同一文件极大概率出错
os.Rename 不是原子操作的“事务”，它本质是两个路径指向的 inode 关系变更。多个 goroutine 同时对同一文件执行 os.Rename（尤其是源或目标有重叠），结果不可预测：可能一个成功、一个报 no such file or directory，甚至出现中间态（源删了、目标没写成，文件丢失）。
没有内置锁机制，得靠你自己控制：
- 按文件路径哈希分桶，用
sync.Map或固定大小的sync.Pool管理 per-path mutex - 更稳妥的做法：所有涉及同一文件的重命名请求，走统一 channel，串行处理
- 避免在 HTTP handler 中直接 rename 用户上传的同名文件——加随机前缀或时间戳，从源头减少冲突
真正难的不是写对一行 os.Rename，而是想清楚它背后没有隐藏的“安全网”：文件系统语义、并发边界、错误恢复路径，都得你一一手动兜住。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
