Go无法在文件开头插入内容，因操作系统不支持字节平移，直接Seek+Write只会覆盖；安全做法是读全量、写临时文件、原子替换，小文件可用os.WriteFile，大文件应避免物理插入而改用逻辑层适配。
直接在文件开头插入内容为什么行不通
Go 没有原生支持「在文件开头插入文本」的系统调用。操作系统层面，os.File 的写入只能覆盖或追加，无法平移后续字节。试图用 file.Seek(0, 0) 后直接 Write，结果是覆盖开头几个字节，后面内容不动——相当于把新内容「盖」在原文件上，不是「插入」。
安全可靠的做法：读全量 + 写新文件 + 原子替换
这是唯一能保证数据不丢失、行为可预测的方式。核心逻辑是：先读取原文件全部内容到内存（注意大文件需分块处理），拼接新行和原内容，写入临时文件，再用 os.Rename 原子替换原文件。
常见错误现象：permission denied（Windows 下原文件被占用）、text file busy（Linux 下直接覆盖正在读的文件）。
- 务必使用
filepath.Join(os.TempDir(), "tmp-"+filepath.Base(src))构造临时路径，避免硬编码 - 写完临时文件后，必须调用
tempFile.Sync()和os.Chmod(tempPath, origInfo.Mode())，否则可能丢失权限或缓冲未刷盘 - 替换前检查临时文件是否完整：用
os.Stat确认大小与预期一致，再执行os.Rename
小文件场景下的简洁实现（io.ReadAll + os.WriteFile）
适合配置文件、日志头注释等 KB 级小文件。不用手动管理 os.File 句柄，出错时原文件完全不受影响。
立即学习“go语言免费学习笔记（深入）”；
content, err := os.ReadFile("config.yaml")
if err != nil {
log.Fatal(err)
}
newContent := append([]byte("# Auto-generated header\n"), content...)
err = os.WriteFile("config.yaml", newContent, 0644)
if err != nil {
log.Fatal(err)
}注意：os.WriteFile 是覆盖写入，不是追加；如果原文件是符号链接，os.WriteFile 会修改目标文件而非链接本身。
大文件或流式处理的替代思路
当文件超百 MB，内存受限时，不能用 ReadAll。此时应放弃「真插入」，改用逻辑层适配：
- 在应用读取时，手动先 yield 新增的头部内容，再按行读原文件——即「虚拟行首」，不改磁盘文件
- 将头部内容拆为独立元数据文件（如
config.yaml.header），主程序启动时合并读取 - 若必须物理插入，用
bufio.NewReader分块读原文件，配合bufio.NewWriter写临时文件，但需自己处理行边界和最后一块的换行符
真正难的不是代码怎么写，而是想清楚：这个「行首添加」是给人看的（比如 README.md 加版本号），还是给程序解析用的（比如 CSV 加 schema 行）。前者可以妥协为追加到末尾再重排；后者往往意味着设计缺陷——文件格式本就不该依赖开头插入来扩展。
