Golang容器日志应统一用zerolog或zap输出结构化JSON，预置container_id、service_name等字段，禁用颜色与装饰，适配stdout/stderr采集链路，确保每行合法可解析。
用 Golang 实现容器日志的格式化与标准化，核心是统一日志结构、注入上下文（如容器 ID、服务名、时间戳）、输出 JSON 或结构化文本，并适配容器运行时（如 Docker、containerd）的日志采集链路（如 stdout/stderr → fluentd / Loki / OpenTelemetry）。关键不在于“重造轮子”，而在于让日志从源头就可被机器解析、可过滤、可关联。
统一使用结构化日志库（推荐 zerolog 或 zap）
避免 fmt.Printf 或 log.Printf 输出非结构化字符串。结构化日志能天然支持字段提取和查询。
- 用 zerolog：轻量、零分配、默认 JSON 输出，适合容器环境
- 用 zap：高性能、支持字段类型丰富，适合高吞吐场景
- 初始化时预置通用字段，例如：
container_id、service_name、env、trace_id（若集成链路追踪）
示例（zerolog）：
log := zerolog.New(os.Stdout).
With().
Str("container_id", os.Getenv("HOSTNAME")).
Str("service_name", "user-api").
Str("env", os.Getenv("ENV")).
Timestamp().
Logger()
log.Info().Str("event", "started").Int("port", 8080).Msg("server listening")
// 输出：{"level":"info","container_id":"app-7f9c4","service_name":"user-api","env":"prod","time":"2024-06-15T10:22:34Z","event":"started","port":8080,"msg":"server listening"}
适配容器标准输出（stdout/stderr），禁用颜色与装饰
容器日志采集器（如 Docker 的 json-file driver、fluentd、Loki 的 promtail）只读取 stdout/stderr 的原始字节流，任何 ANSI 颜色、进度条、重复前缀都会干扰解析。
立即学习“go语言免费学习笔记（深入）”；
- 关闭日志库的颜色输出（如 zap.NewDevelopmentConfig().DisableColor = true）
- 禁止在每行开头手动拼接时间/级别（结构化日志已内置）
- 确保 panic/fatal 日志也走同一 logger（zerolog 通过
log.With().Caller().Stack().Fatal()捕获堆栈）
注入容器运行时上下文（自动或显式）
理想情况下，日志中应包含真实容器元数据，而非硬编码或空值：
- Pod 名称、Namespace（K8s 环境）：通过 Downward API 注入环境变量或挂载文件（如
/etc/podinfo/labels） - 容器 ID：Docker 中可通过
/proc/1/cgroup解析（cgroup v1/v2 路径不同），或直接用os.Getenv("HOSTNAME")（需确保 Pod hostname 设置为 containerID） - 建议封装一个
GetRuntimeContext()工具函数，在 logger 初始化时调用一次即可
对接日志后端（可选但推荐）
如果业务有集中日志需求，可在 Golang 中直连 Loki（HTTP 推送）或 OpenTelemetry Collector（OTLP 协议），但更常见且稳妥的做法是：
- 保持 stdout 输出 JSON 日志（如上）
- 由 infra 层配置采集器（如 promtail → Loki，或 filebeat → ES）做字段提取与路由
- 必要时，在 Golang 中加一层简单中间件：对 error 日志自动附加
"error_type"、"stack"字段（zerolog 支持.Err(err)自动展开）
基本上就这些。不需要复杂框架，关键是让每一行 stdout 都是合法 JSON、含必要上下文、无干扰字符——这样 Prometheus + Loki + Grafana 查日志、设告警、做聚合，才真正高效可靠。
