Go无法在文件开头直接插入内容，必须读取原文件、拼接新内容后写入临时文件，再原子替换原文件；小文件可用os.ReadFile/os.WriteFile，大文件需流式处理避免OOM。
Go 无法直接在文件开头“插入”内容
Go 的 os.File 不支持在文件中间或开头插入数据——底层系统调用（如 write()）只能覆盖或追加，插入需要重写后续全部内容。所谓“开头插入”，本质是：读取原文件全部内容 → 拼接新内容 + 原内容 → 写回文件。
最安全的做法：用临时文件 + 原子替换
直接覆写原文件有风险（写到一半崩溃会导致数据丢失）。正确流程是先写入临时文件，再用 os.Rename() 原子替换：
- 用
os.ReadFile()读取原文件字节（注意内存占用，大文件需流式处理） - 构造新内容：
append([]byte(newHeader), oldContent...) - 用
os.WriteFile(tempPath, newData, 0644)写临时文件 - 用
os.Rename(tempPath, originalPath)替换原文件（Linux/macOS 原子；Windows 需同盘符）
小文件直接读写示例（含换行处理）
常见需求是给 Go 源文件加 license 注释头，注意保留原始换行符：
content, _ := os.ReadFile("main.go")
newHeader := []byte("// Copyright 2024\n// SPDX-License-Identifier: MIT\n\n")
// 确保 header 后有空行，避免和原文件首行粘连
if len(content) > 0 && content[0] != '\n' {
newHeader = append(newHeader, '\n')
}
newContent := append(newHeader, content...)
os.WriteFile("main.go", newContent, 0644)
⚠️ 注意：os.ReadFile 会把 BOM、CR/LF 全部保留；若原文件以 \r\n 结尾，拼接后可能混用换行符。
大文件必须流式处理（避免 OOM）
文件超过几十 MB 就不该全量读入内存。需用 io.Pipe 或分块读写：
- 打开原文件
os.Open()和临时文件os.CreateTemp("", "insert-*.tmp") - 先写入新内容到临时文件（
io.WriteString()） - 再用
io.Copy()把原文件剩余内容流式拷贝过去 - 关闭所有句柄后调用
os.Rename()
关键点：io.Copy() 不吃内存，但要注意原文件读取位置——如果原文件已打开，需确保从 offset 0 开始读（默认就是）。
最容易被忽略的是权限和符号链接：原文件的 os.FileInfo.Mode() 和所属用户不会自动继承到新文件，os.Rename() 也不处理 symlink。如果目标是软链，得先 os.Readlink() 解析真实路径再操作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
