Golang日志格式与时间前缀设置

本文深入解析了Go语言标准日志库（log）的格式化与时间前缀配置核心技巧：通过位掩码组合（如log.Ldate | log.Ltime | log.Lshortfile）灵活控制日志元信息，用SetPrefix()添加模块标识前缀，并指出其全局影响与手动补全空格的易错点；特别强调SetFlags无法实现RFC3339等自定义时间格式，必须通过重写Output方法配合自定义io.Writer来达成；最后强烈推荐摒弃全局logger修改，转而使用log.New()创建隔离、可扩展的日志实例——这不仅保障线程安全和输出可控性，更为后续接入分级日志、JSON序列化或高性能日志库（如zap）预留清晰架构路径，避免因早期裸写fmt.Printf导致后期重构举步维艰。

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 的输出函数：

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的相关知识，也可关注golang学习网公众号。