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)→2024/05/20 14:23:11 handler.go:42: user login failed
创建带前缀和标志的独立 logger(推荐做法)
避免污染全局 logger,尤其在多模块共存或测试场景中:
立即学习“go语言免费学习笔记(深入)”;
- 用
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)补足上下文










