直接并发写*os.File会出错，因其Write()不保证原子性，多goroutine写同一fd会导致覆盖、截断、空字节等问题；必须用全局sync.Mutex锁住所有写入路径，且锁内仅执行Write()，格式化等耗时操作须移至锁外。
为什么直接并发写 *os.File 会出错
Go 的 *os.File 不是并发安全的——它的 Write() 方法内部同时操作文件偏移量和底层缓冲区。多个 goroutine 并发调用时，会相互覆盖写入位置，导致日志行拼接、内容截断、空字节填充，甚至 go run -race 直接报出 Write at 0x... by goroutine N 竞态警告。这不是 Go 实现缺陷，而是 POSIX 文件语义本身就不保证对同一 fd 的并发 write() 原子性。
sync.Mutex 锁什么、怎么锁才有效
关键不是“加了锁”，而是锁的对象和范围是否匹配实际写入行为：
- 锁对象必须是全局或结构体字段级变量（如
var logMu sync.Mutex），绝不能在函数内声明——否则每个 goroutine 拿到的是不同锁，形同虚设 - 所有写入路径必须经过同一把锁：包括
logFile.Write()、logFile.WriteString()、甚至fmt.Fprintln(logFile, ...)，只要底层最终调用*os.File.Write就得被包住 - 必须用
defer mu.Unlock()紧跟mu.Lock()，否则 panic 或死锁风险极高；提前 return、中间 error、panic 都不会跳过 defer - 锁内只做纯 I/O：把格式化、JSON 编码、时间格式化等耗时操作全移到锁外，只把最终
[]byte交由Write() - 若一次逻辑需多次
Write()（比如写 header + body + footer），必须全部塞进同一个Lock()/Unlock()块里，分段加锁等于没锁
比 sync.Mutex 更适合高频日志写的替代方案
当写入频率高、单次数据小（如 HTTP 请求日志），sync.Mutex 会让所有 goroutine 排队，吞吐卡在单点 I/O 上。这时应考虑：
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
- 用 channel + 单 writer goroutine：生产者发
[]byte到chan []byte，一个 dedicated goroutine 从 channel 收、批量合并、加缓冲、再顺序落盘——天然无锁，还能控制 flush 频率 - 每个 goroutine 写独立临时文件（带 PID 或随机后缀），最后用
os.Rename()原子合并——适用于批处理，但注意os.Rename()在 Windows 上跨磁盘会失败 -
sync.RWMutex对纯写场景无帮助：它只优化读并发，写仍是排他，和Mutex效果一致
容易被忽略的底层细节
很多人以为锁住 Write() 就万事大吉，但还有几个硬伤常被绕过：
立即学习“go语言免费学习笔记（深入）”；
- 忘记检查
logFile是否已关闭：如果某处调用了logFile.Close()，后续写入会 panic，而锁不保护这个状态——应在锁内加if logFile == nil或封装成带状态检查的写函数 - 误以为
bufio.Writer自带线程安全：它只是缓冲包装，底层仍调*os.File.Write()，必须和*os.File共享同一把锁，或整个bufio.Writer实例由单 goroutine 独占 - 在 defer 中关闭文件但没锁保护：
defer logFile.Close()若与并发写共存，可能在写中途关闭 fd，导致 write 失败或 panic——关闭操作也应纳入锁范围，或确保关闭前已无活跃写请求
