go 文件写入需三步：先用os.stat判断存在性，再用高精度时间戳生成唯一备份名，最后通过同目录临时文件+os.rename实现原子写入；须处理权限继承、跨分区rename失败及临时文件清理。
Go 语言没有内置文件版本控制或自动备份机制，所有逻辑必须手动编码实现；核心在于「写入前判断存在性」「备份名带高精度时间戳」「临时文件+原子重命名」三步缺一不可。
os.Stat 判断文件是否存在才能决定是否备份
不能依赖 os.OpenFile 的返回错误来判断文件是否已存在——它在文件存在时不会报错，而是直接截断写入，旧内容彻底丢失。
- 正确做法是先调用
os.Stat("config.yaml")，若err == nil，说明文件存在，触发备份流程 - 若
os.IsNotExist(err)成立，则可跳过备份，直接写入新内容 - 别用
os.ReadFile替代os.Stat：前者会把整个文件读进内存，对大文件不友好且没必要
备份文件名必须用 time.Now().Format("20060102150405") 生成
静态后缀如 .bak 或 .old 会导致多次写入后反复覆盖，历史版本无法追溯。
-
time.Now().Unix()是秒级精度，在快速连续写入（如测试循环、CI/CD 部署）下极易重复，不可用于生成唯一备份名 - 推荐格式：
config.yaml.20260614132801，既可读又支持 shell 脚本按字典序清理（如ls -t config.yaml.* | tail -n +4 | xargs rm） - 拼接路径务必用
filepath.Join(dir, base+"."+timestamp)，避免手动拼"\"或"/"导致 Windows 下路径错误
写入必须通过临时文件 + os.Rename 实现原子性
最危险的情况是：备份成功了，但新文件写入失败（磁盘满、权限不足），结果旧文件被删、新文件没写成，配置全丢。
- 临时文件必须和目标文件同目录，否则跨分区
os.Rename会失败（返回syscall.EXDEV） - 写完临时文件后，记得用
os.Chmod(tmpPath, fi.Mode())复制原文件权限，否则恢复后可能因权限缺失导致服务启动失败 - 备份动作要放在
os.Rename之前，且独立执行；即使备份失败，只要os.Rename成功，系统仍可用
返回 writeErr 和 backupErr 两个 error 便于上层区分处理
把「写入失败」和「备份失败」混成一个 error 返回，会让调用方无法判断是配置根本没更新成功，还是只是历史版本没留好。
-
writeErr绝对不可忽略——它代表本次变更未落地，业务可能处于不一致状态 -
backupErr可选择性忽略（比如仅用于审计日志），但建议至少记录 Warn 级别日志 - 临时文件清理不能靠 defer：万一
os.Rename失败，需显式os.Remove(tmpPath)，否则残留 .tmp 文件越积越多
真正容易被忽略的是权限继承和跨分区 rename 失败这两种情况——它们不会在开发机上暴露，却常在生产环境的 NFS 挂载点或容器 volume 中突然触发。写入前务必验证目标路径的 os.Stat 结果和所在文件系统类型。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
