Go log包不支持错误级别和结构化输出，需替换默认logger、补齐上下文、控制格式与目标；推荐zap/zerolog，记录error时保留错误链和调用栈，按严重性分流输出，避免无效日志。
Go 标准库的 log 包本身不支持错误级别（如 ERROR/WARN/DEBUG）或结构化输出，直接用它记录错误容易丢失上下文、难以过滤，也不便于接入 ELK 或 Loki。要构建可用的错误日志系统，核心是「替换默认 logger + 补齐上下文 + 控制输出格式与目标」。
用 log.New 或第三方库替换默认 log 实现
标准 log.Printf 无法区分错误和其他日志，且没有返回值，无法做错误传播判断。应避免全局使用 log.Fatal，改用可组合的 logger 实例。
- 轻量场景：用
log.New封装os.Stderr，配合前缀和标志位（如log.LstdFlags | log.Lshortfile）快速定位错误位置 - 生产环境：推荐
zap（高性能）或zerolog（零分配），它们原生支持Error()、Warn()方法，并能自动提取error类型字段（如err.Error()、err.Unwrap()） - 切忌在多个包里各自调用
log.SetOutput—— 它是全局副作用，会导致日志目标被意外覆盖
记录错误时必须携带调用栈与原始 error 值
只记录 err.Error() 字符串等于丢掉所有诊断线索。Go 1.13+ 的错误链（fmt.Errorf("wrap: %w", err)）必须保留，否则无法用 errors.Is 或 errors.As 判断错误类型。
- 用
zap.Error(err)或zerolog.Err(err)而不是zap.String("error", err.Error()) - 需要栈信息时，手动调用
debug.PrintStack()不够精准；zap的With(zap.String("stack", string(debug.Stack())))是可行但开销大；更稳妥的是在 error 包装时用fmt.Errorf("%w at %s:%d", err, file, line)手动注入位置 - HTTP handler 中常见错误（如
json.Unmarshal失败）不要直接log.Println(err)，应包装为带请求 ID 和路径的结构化字段
按错误严重性分流日志输出目标
不是所有错误都该写入同一文件或上报 Sentry。高频 warn（如限流触发）和致命 panic 必须分离处理，否则会淹没真正需要人工介入的问题。
立即学习“go语言免费学习笔记（深入）”；
-
ERROR级别日志建议同时写入本地文件（轮转）+ 推送到集中式日志服务（如 Loki 的push_api） -
WARN可仅写入文件，或通过采样（如每 100 次记录 1 次）降低上报压力 - panic 级别需额外触发
runtime/debug.Stack()并强制 flush 日志缓冲区（logger.Sync()），防止进程退出前日志丢失 - 避免在日志写入逻辑中调用网络 I/O（如直连 Sentry SDK），应走异步 channel + worker 模式，防止阻塞主业务流程
真正的难点不在“怎么打日志”，而在于“什么时候不该打”——比如重试循环里的中间错误、已知的客户端参数错误，这些本就不该进 ERROR 流。错误日志的价值取决于你能否在 5 秒内从海量日志里定位到那个唯一需要修复的 bug，而不是堆砌所有 if err != nil 分支。
