高性能日志系统需异步不阻塞、批量刷盘、可控滚动、内存可控；直接SetOutput写文件因同步write+全局锁+格式化开销导致高并发卡顿，且并发写同一文件易致日志粘连；自研须含限容channel、单消费goroutine、bufio.Writer、预分配batch；滚动须close+rename防句柄泄漏；生产推荐zap+lumberjack，注意MaxSize单位、目录权限、Tee多输出及脱敏前置。
标准库 log 直接写文件扛不住每秒几百条以上日志，高并发下会卡住主 goroutine；真正可用的高性能文件日志系统必须满足：异步不阻塞、批量刷盘、滚动可控、内存不暴涨。
为什么不能直接用 log.SetOutput() 重定向到文件
因为 log.Printf() 每次调用都同步执行 os.File.Write()，底层是系统调用 + 全局锁 + 字符串格式化三重开销。压测时容易看到：goroutine 大量阻塞在 write(2)，CPU 不高但延迟毛刺严重，磁盘 I/O wait 拉满。更隐蔽的问题是：多个 goroutine 并发写同一 *os.File，即使开了 O_APPEND，在 ext4 上仍可能因内核页缓存导致日志行粘连或截断。
自研异步刷盘必须带缓冲、单写协程和 bufio.Writer
仅用 go func() { file.WriteString() }() 或无缓冲 chan string 是典型错误——它没解决批量、没控制背压、没防止单点卡死。最小可行结构要包含四要素：
-
logChan := make(chan *LogEntry, 1024)：缓冲区必须设上限，1024 是安全起点，按压测峰值 ×3～5 设置（如 800 条/秒 → 设 4096） - 单个消费 goroutine：
for range logChan持续读取，别用select轮询空 channel，避免 CPU 空转 -
bufio.NewWriterSize(file, 16*1024)：显式设缓冲大小，避免默认 4KB 太小；w.Flush()只刷到内核 buffer，file.Sync()才真正落盘（ERROR 级别必须加） - batch 切片预分配：
batch := make([]*LogEntry, 0, 128)，避免高频扩容触发 GC
文件滚动必须 close + rename，不能只 rename
滚动时只 os.Rename() 不 file.Close() 会导致句柄泄漏，lsof -p PID | grep your-log 一眼可见堆积的 deleted 文件。常见错误还有：
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
立即学习“go语言免费学习笔记（深入）”；
- 用
os.Create()新建文件 → 权限变成0600，而非预期的0644 - 没检查
syscall.ENOSPC→ 磁盘满时静默丢日志或 panic - 滚动逻辑放在定时器里轮询 → 额外 goroutine 和时间精度误差
正确做法：每次写入前用 os.Stat() 查当前文件大小，超限时先 f.Close() 再 os.Rename()，新日志用新 os.OpenFile(path, os.O_WRONLY|os.O_CREATE|os.O_APPEND, 0644) 句柄。
zap 生产环境配置绕不开 lumberjack 和 zapcore.NewTee
自己手写滚动和异步太重，生产推荐 zap + lumberjack 组合。关键点不是“能不能用”，而是配置是否踩坑：
-
lumberjack.MaxSize单位是 MB（不是 KB），设100就是 100MB；启动前必须os.MkdirAll(filepath.Dir(logPath), 0755)确保目录权限 - 想同时输出到控制台（人类可读）和文件（机器可解析），必须用
zapcore.NewTee()合并两个 core，不能靠io.MultiWriter -
zap.NewProduction()默认输出到 stderr，要写文件得手动构造zapcore.Core，encoder 用zapcore.NewJSONEncoder(zap.NewProductionEncoderConfig()) - 验证是否真高性能：
go test -bench=. -benchmem看allocs/op是否 ≤ 0.5；一旦 > 1，说明某处用了fmt.Sprintf或 development encoder
最易被忽略的是：脱敏必须在主线程做完再进 channel，后台 goroutine 拿不到 http.Request 或 context，强行做会 panic 或性能劣化。
