go-util

go-util

logging

仓库内已新增终局版日志模块设计与第一版实现骨架：

• 设计稿：DESIGN_logging_refactor.md
• 实施清单：IMPLEMENTATION_CHECKLIST_logging_refactor.md
• 新模块：logging/
• 使用说明：logging/README.md

当前推荐使用 logging，不再以旧 log/ 作为后续新接入目标。

旧 log/ 包状态

旧 github.com/imdm/go-util/log 已标记为 deprecated：

• 仅保留给历史代码
• 不再作为新代码接入入口
• 后续统一收口到 github.com/imdm/go-util/logging

初始化

logger := logging.MustNewLogger(logging.Config{
	Service:      "example-service",
	Env:          "prod",
	Version:      "v1.0.0",
	Format:       logging.AutoFormat,
	Level:        logging.InfoLevel,
	AppWriter:    os.Stdout,
	AccessWriter: os.Stdout,
	ErrorWriter:  os.Stderr,
	AddCaller:    true,
})

net/http 接入

handler := logginghttp.NewAccessLogMiddleware(logger, logginghttp.AccessLogConfig{
	RequestIDHeader: "X-Request-ID",
	RecoverPanic:    true,
})(mux)

请求内追加字段

func Handle(w http.ResponseWriter, r *http.Request) {
	log := logging.MustFromContext(r.Context())
	log.AppendRequestLogField("order_id", "o_123")
	log.AppendRequestLogMessage("request handled")
	w.WriteHeader(http.StatusOK)
}