os.Rename不覆盖同名文件，需先用os.Stat判断目标存在性并按策略处理；跨设备时须复制+删除，全程需防竞态、权限、目录误删等问题。
文件名重复时，os.Rename 直接失败并返回 file exists
Go 的 os.Rename 不会覆盖目标文件，只要目标路径已存在，就立即返回 rename …: file exists（Windows 下是 The file exists）。这不是 bug，是设计使然——它对标 Unix 的 rename(2) 系统调用语义，不支持强制覆盖。
所以不能指望靠重试或忽略错误来“强行重命名”，必须提前判断、主动处理冲突。
- 先用
os.Stat检查目标路径是否存在 - 若存在，需决定策略：跳过、覆盖（先
os.Remove）、或生成新名（如加序号、时间戳） - 注意：
os.Stat对目录也返回 nil error，所以得用os.IsNotExist(err)判断“真不存在”
安全覆盖方案：先删再重命名，但要防误删
如果业务允许覆盖（比如日志轮转、缓存更新），可以手动 os.Remove 目标文件后再 os.Rename。但必须小心：目标可能是目录，或权限不足，或正被其他进程占用。
- 用
os.RemoveAll代替os.Remove会误删目录，绝对避免 - 正确做法是先
os.Stat，再检查fi.Mode().IsRegular()确保是普通文件才删 - 删除后仍要检查
os.Rename是否成功——因为可能刚删完就被另一个进程创建了同名文件（竞态） - 更健壮的做法是：用
os.OpenFile(dst, os.O_CREATE|os.O_WRONLY|os.O_EXCL, 0644)尝试独占创建，成功则写入源内容，失败说明已被占用
生成唯一文件名：推荐用 filepath.Base + 时间戳或哈希
对用户上传或自动下载场景，更常用的是“自动避让”而非覆盖。核心是保持原文件名语义，只在末尾追加标识。
Alibabacloud Sdk Client Initialization For Golang
下载
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 不要直接拼字符串，用
filepath.Join和filepath.Dir处理路径，避免 Windows/Linux 路径分隔符问题 - 提取原始文件名用
filepath.Base(src)，扩展名用filepath.Ext(name)，名字主体用strings.TrimSuffix(name, ext) - 简单加序号（如
report (1).pdf）需循环检测，效率低；推荐用纳秒级时间戳：fmt.Sprintf("%s_%d%s", base, time.Now().UnixNano(), ext) - 若需可读性+唯一性，可用
md5.Sum([]byte(src + dst + time.Now().String()))取前8位 hex，但注意 md5 不适合加密场景
os.Rename 跨设备移动会失败，此时必须复制+删除
当源和目标不在同一文件系统（比如从 /tmp 移到 /home），os.Rename 返回 invalid cross-device link。这是内核限制，Go 无法绕过。
- 必须 fallback 到“复制 + 删除”流程：用
io.Copy写入新文件，再os.Remove源文件 - 复制前记得
os.Chmod(dst, fi.Mode())保留权限，否则新文件默认是 0644 - 复制完成后，用
os.SameFile校验源目标是否一致（避免静默失败），再删源 - 整个过程无原子性，异常退出可能导致源删了、目标没写完——生产环境建议先复制到临时名，成功后再
os.Rename原子切换
真正麻烦的从来不是“怎么改名字”，而是“改名过程中谁在读它、谁在写它、磁盘是不是满了、路径有没有中文、符号链接怎么算”。每一步都得带兜底，而不是相信 rename 一定成功。
