必须用 os.O_CREATE | os.O_WRONLY | os.O_TRUNC 组合才能安全覆盖文件，否则会残留旧数据；os.WriteFile 虽自动截断但并发不安全、大文件易OOM；小文件覆盖后需调用 f.Sync() 确保落盘。
直接覆盖写入已有文件，必须用 os.OpenFile 配合 os.O_TRUNC，缺它就会出事——不是报错，就是静默覆盖开头几字节，留下一堆旧数据尾巴。
os.OpenFile 的 flag 组合决定是否真正覆盖
Go 没有“覆盖写”这个独立语义，行为全靠 os.OpenFile 的 flag 参数组合。常见错误是只写 os.O_WRONLY | os.O_CREATE，结果文件从头开始写但不截断，新内容盖住开头，后面全是残留旧数据。
-
os.O_CREATE | os.O_WRONLY | os.O_TRUNC：安全覆盖 —— 文件存在则清空（截断为 0 字节），不存在则创建 -
os.O_WRONLY | os.O_TRUNC（无os.O_CREATE）：仅覆盖已有文件，若文件不存在会报open xxx: no such file or directory -
os.O_CREATE | os.O_WRONLY（漏掉O_TRUNC）：最危险 —— 写多少字节就覆盖多少字节，后面内容原封不动残留
os.WriteFile 只能覆盖，但不适合高频或大文件
os.WriteFile 内部固定使用 os.O_CREATE | os.O_WRONLY | os.O_TRUNC，每次调用都重开文件、全量写入、立即关闭。它看起来简单，但有硬伤：
- 并发下绝对不安全：两个 goroutine 同时调用，后者必然覆盖前者结果
- 大文件性能差：每次都把整个内容加载进内存再 syscall，容易 OOM
- 无法做原子替换：不能先写临时文件再 rename，
os.WriteFile不暴露文件句柄
适合场景仅限「一次性写入完整快照」，比如保存配置、导出 JSON 报告。
立即学习“go语言免费学习笔记（深入）”；
小文件覆盖后记得 f.Sync()，否则可能丢数据
即使你用 os.OpenFile 正确打开并 Write 完毕，Linux/macOS 下仍可能因内核页缓存未刷盘而丢失最后一批写入 —— 尤其在程序异常退出或机器断电时。
- 调用
f.Sync()强制落盘（注意：比Close()更严格，Close()不保证数据已写入磁盘） - 如果用了
bufio.NewWriter(f)，必须先bufWriter.Flush()再f.Sync() - Windows 下
f.Sync()效果有限，但仍是必要步骤
跨平台换行和权限要手动处理
覆盖写入不是“写完就完”，Windows 和 Unix 行为差异会在结果上直接暴露：
- 换行符：Go 默认用
\n，Windows 记事本只认\r\n；若目标是给人看的日志或配置，写前手动补\r\n - 权限：0644 在 Windows 上基本无效，但首次创建时若父目录不可写，
os.OpenFile会在 open 阶段就报permission denied - 实操建议：覆盖前用
os.Stat检查父目录可写性，而不是依赖 mode 参数
真正难的不是怎么写那几行 flag，而是想清楚「这次覆盖要不要阻塞后续写入」「有没有其他进程正在读这个文件」「失败后要不要保留旧文件副本」——这些逻辑不在 os 包里，得你自己兜底。
