os.rename是go中唯一标准的重命名函数，兼具改名与移动功能，但仅限同一文件系统内；跨设备会报“invalid cross-device link”；目标存在时行为平台不一，需显式检查处理；路径拼接必须用filepath.join并clean，避免遍历与非法字符。
os.Rename 是唯一标准操作，但不是万能的
Go 中没有 RenameFile、MoveFile 等别名函数，os.Rename 就是全部——它既改名也移动，底层直调系统 rename(2)，快且原子。但它只在**同一文件系统内有效**：跨磁盘、跨挂载点（如 Docker volume 与 /tmp）、WSL 中 Windows 与 Linux 路径混用，都会失败，报错 "invalid cross-device link"。这不是权限或路径写错，而是操作系统硬限制，绕不过。
目标路径已存在时，行为完全不一致
Linux/macOS 下 os.Rename 可能直接覆盖目标文件（尤其空文件），Windows 则几乎必然失败，报 "file exists" 或 "Access is denied"。不能依赖“覆盖”语义，生产代码必须显式控制：
- 用
os.Stat(dst)检查目标是否存在；若存在，按需决定跳过、加后缀、或先os.Remove(dst)（注意：Remove 也可能失败） - 若目标是目录且非空，
os.Rename在所有平台都失败，不可用于“把文件塞进目录” - Windows 下若目标正被记事本、VS Code 占用，会卡在
Access is denied，无绕过手段，只能提示用户关闭进程
跨设备重命名必须手动复制 + 删除
捕获 syscall.EXDEV 错误后，降级逻辑不是简单 ioutil.ReadFile → ioutil.WriteFile（大文件会 OOM），而是流式处理：
- 用
os.Open(src)和os.Create(dst)获取句柄，再用io.Copy流式复制，不加载全文件到内存 - 复制成功后，调用
os.Chmod(dst, srcInfo.Mode())和os.Chtimes(dst, srcInfo.ModTime(), srcInfo.ModTime())同步权限与时间戳（默认不会继承） - 最后才
os.Remove(src)；任一环节失败，原文件必须保留，目标文件若已部分写入，应主动os.Remove(dst)清理 - 别忘了提前
os.MkdirAll(filepath.Dir(dst), 0755)，os.Rename从不创建父目录
路径拼接和清理是高频翻车点
手拼 "dir/" + filename 在 Windows 上生成 dir/\file.txt，直接触发 "The filename, directory name, or volume label syntax is incorrect."。正确做法只有两个：
- 所有路径拼接一律用
filepath.Join("data", "log.txt")，自动适配分隔符并归一化..和重复斜杠 - 对用户输入或配置拼出的路径，必须先
filepath.Clean()再传给os.Rename，防止../etc/passwd类路径遍历 - 相对路径容易受工作目录影响，关键操作建议统一转为绝对路径：
filepath.Abs(src)
真正难的不是写对 os.Rename，而是预判它在哪一步会静默失败：父目录不存在、目标被占用、跨挂载点、路径含非法字符……这些必须在调用前检查，而不是等错误返回再处理。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
