log.SetFlags()通过位掩码控制日志元信息,如log.Ldate|log.Ltime|log.Lshortfile;SetPrefix()设置行首固定前缀;自定义时间格式需重写Output;推荐用log.New()创建独立实例而非修改全局logger。

log.SetFlags() 控制时间、文件名、行号等元信息
Go 标准库 log 默认只输出内容,不带时间戳;想加时间、调用位置等,必须调用 log.SetFlags()。它接收一个整数位掩码,常见组合有:
-
log.LstdFlags:等价于log.Ldate | log.Ltime,输出形如2024/01/01 12:34:56 -
log.Lmicroseconds:替换Ltime,显示微秒(12:34:56.123456) -
log.Lshortfile或log.Llongfile:显示main.go:23或完整路径 - 多个标志用
|拼接,例如log.Ldate | log.Ltime | log.Lshortfile
注意:log.SetFlags() 影响所有通过 log.Print* 发出的日志(包括 log.Printf),且全局生效——如果项目中混用多个 logger 实例,它只作用于默认的 log.Logger。
log.SetPrefix() 设置每条日志开头的固定字符串
log.SetPrefix() 用于给每条日志行首加统一前缀,比如服务名或模块标识:
log.SetPrefix("[API] ")
log.Println("request received") // 输出:[API] request received
这个前缀是纯字符串,不参与格式化,也不受 SetFlags 影响。它只对默认 logger 生效;如果你用 log.New() 创建了自定义 logger,则需在创建时指定 prefix,或调用该实例的 SetPrefix() 方法。
容易踩的坑:SetPrefix() 不会自动加空格或冒号,得自己写清楚,否则可能变成 [API]request received 这种粘连效果。
自定义时间格式只能靠重写 Output,不能用 SetFlags
log.SetFlags() 只支持预设的时间格式(Ldate/Ltime/Lmicroseconds),无法指定 2006-01-02T15:04:05Z07:00 这类 RFC3339 格式。真要定制,必须替换 logger 的输出函数:
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器,提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象,支持命名依赖等
logger := log.New(os.Stdout, "", 0) // flags 设为 0,禁用默认时间
logger.SetOutput(&prefixWriter{logger: logger})
然后实现一个满足 io.Writer 接口的结构体,在 Write([]byte) 里手动拼接 time.Now().Format("2006-01-02 15:04:05") 和原始日志内容。标准库不提供“设置时间模板”的 API,这是硬限制。
多数场景下,建议直接用 log.New() 配合 io.MultiWriter + 自定义 writer,而不是动全局 log 包——避免影响第三方库的日志行为。
为什么不用 fmt.Printf + time.Now() 替代?
有人图省事直接写 fmt.Printf("[%s] %s\n", time.Now().Format(...), msg),但这绕过了 log 包的线程安全、输出目标控制(如重定向到文件)、以及 log.SetOutput() 的统一管理能力。更关键的是:一旦需要按 level 分级(info/warn/error),或集成 zap/logrus 等高级库,这种裸写方式会成为重构瓶颈。
所以,哪怕只是基础日志,也应优先走 log.New() 构造独立实例,并明确区分「谁负责格式」、「谁负责输出」、「谁负责级别」——哪怕现阶段没分级,留好扩展缝。
真正麻烦的不是加时间戳,而是后续想加 caller 跟踪、JSON 输出、异步刷盘时,发现日志散落在各处 printf 里。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!










