17370845950

Go 中应优先创建带前缀和标志的独立 logger，如 log.New(os.Stdout, "[DB] ", log.LstdFlags|log.Lshortfile)；SetPrefix 和 SetFlags 仅影响全局默认 logger，且需手动添加分隔符，推荐生产环境关闭 Lshortfile 并接入集中式日志系统。

在 Go 中使用 log 包设置自定义前缀和标志，能显著提升日志的可读性与调试效率。关键在于调用 log.SetPrefix() 和 log.SetFlags()，且需注意它们只对全局默认 logger（log.Println 等）生效；若用自定义 logger，则应在初始化时配置。

设置统一的日志前缀（Service/Module 标识）

前缀用于标识日志来源，比如服务名、模块名或环境，便于快速定位问题归属。

• 使用 log.SetPrefix("[API] ")，后续所有 log.Println("request received") 输出为：[API] request received
• 前缀不自动加空格或分隔符，需手动添加（如 "[auth] " 或 "DEBUG: "）
• 若需动态前缀（如按请求 ID），不宜依赖全局前缀，应改用自定义 logger 或结构化日志库（如 zap）

启用有意义的时间戳和位置信息（通过 SetFlags）

log.SetFlags() 控制日志行的元信息，常用组合可增强上下文：

• log.LstdFlags：输出时间（年-月-日 时:分:秒）
• log.Lmicroseconds：替换秒级时间为微秒级（更精确）
• log.Lshortfile：显示文件名+行号（如 handler.go:42）
• log.Llongfile：显示完整路径（通常冗余，少用）
• 推荐组合：log.SetFlags(log.LstdFlags | log.Lshortfile) → 2025/05/20 14:23:11 handler.go:42: user login failed

创建带前缀和标志的独立 logger（推荐做法）

避免污染全局 logger，尤其在多模块共存或测试场景中：

• 用 log.New(os.Stdout, "[DB] ", log.LstdFlags|log.Lshortfile) 创建专用 logger
• 返回值是 *log.Logger，支持 Printf、Println、Fatal 等方法
• 可封装为包级变量或注入到结构体中，例如：
  var dbLog = log.New(os.Stdout, "[DB] ", log.LstdFlags|log.Lshortfile)

注意事项与常见误区

几个易忽略但影响实际效果的细节：

• SetPrefix 和 SetFlags 对已创建的自定义 logger 无效，只作用于默认 logger
• 并发安全：标准 log.Logger 是并发安全的，无需额外加锁
• 日志输出目标：默认写入 os.Stderr，如需写入文件，传入 os.File 句柄（记得检查错误并关闭）
• 生产环境建议：关闭 Lshortfile（减少 I/O 开销），用集中式日志系统（如 Loki + Promtail）补足上下文