Golang自定义日志格式与SetFlags使用技巧

小伙伴们有没有觉得学习Golang很有意思？有意思就对了！今天就给大家带来《Golang自定义日志格式与SetFlags详解》，以下内容将会涉及到，若是在学习中对其中部分知识点有疑问，或许看了本文就能帮到你！

log.SetFlags仅控制日志前缀的自动附加内容（如时间、文件名、行号等），不改变日志消息本身，也不支持自定义格式；其参数为位掩码，由log包预定义常量组合而成。

Go 标准库 log 的 SetFlags 能控制什么

log.SetFlags 只影响日志前缀的**自动附加内容**，比如时间、文件名、行号等；它不改变日志消息本身，也不支持自定义格式字符串（如 %s [%d]）。如果你看到日志开头有类似 2024/05/20 14:23:11 main.go:12: 这样的前缀，就是 SetFlags 在起作用。

它的参数是一个整数位掩码，由 log 包预定义的常量组合而成。常见选项包括：

• log.Ldate：输出年/月/日（2024/05/20）
• log.Ltime：输出时:分:秒（14:23:11）
• log.Lmicroseconds：用微秒替代 Ltime（14:23:11.123456）
• log.Llongfile：输出完整文件路径（/home/user/proj/main.go）
• log.Lshortfile：只输出 main.go:12 这种格式
• log.Lmsgprefix：让 log.Prefix() 返回的内容出现在每条日志最前面（需配合 SetPrefix）
• log.LUTC：用 UTC 时间代替本地时间（和 Ldate/Ltime 搭配生效）

默认值是 log.Ldate | log.Ltime，也就是带日期和时间。

如何正确组合 SetFlags 参数

用按位或（|）连接多个标志，顺序无关。错误写法是传多个参数或用加法——Go 函数只接受一个 int 参数。

log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.SetFlags(log.Lmicroseconds | log.LUTC | log.Lshortfile)
log.SetFlags(0) // 关闭所有自动前缀（只剩你写的字符串）

注意：log.Lshortfile 和 log.Llongfile 互斥，同时设也没问题，但最终只生效后者（因为 Llongfile 值更大，且内部逻辑优先匹配长路径）；实际建议只选其一。

另外，log.LUTC 单独设置无效，必须和 Ldate 或 Ltime 一起用，否则时间仍按本地时区输出。

为什么 SetFlags 不能实现 JSON 或带 level 的日志

因为 log.SetFlags 的设计目标只是“加点元信息前缀”，不涉及结构化字段、级别标记（info/warn/error）、颜色、输出到多目标等能力。它连 level 都没有——log.Print、log.Fatal 看似有语义，但底层都是调同一套输出逻辑，Fatal 只是在打印后调 os.Exit(1)。

所以如果你需要：

• 输出 {"level":"info","ts":"2024-05-20T14:23:11Z","msg":"user logged in"}
• 不同 level 用不同颜色或文件
• 同时写入文件 + 控制台

就必须换库，比如 zap、zerolog、logrus。标准库 log 不提供这些能力，硬绕（比如自己拼 JSON 字符串再 Println）会丢失 SetFlags 的一致性，也难以统一管理。

调试时容易忽略的两个细节

log 包的配置是全局的，一旦 SetFlags 或 SetOutput，会影响所有通过 log.Xxx（如 log.Println）发出的日志，包括第三方包里没做隔离的调用。这在依赖多、日志混杂的项目中容易引发意外。

另一个坑是：如果你用 log.New 创建了自定义 logger（比如 mylog := log.New(...)），它的 flags 是独立的，log.SetFlags 不会影响它。必须对那个实例调 mylog.SetFlags(...)。

也就是说：log.SetFlags 只作用于标准 logger（即 log.Printf 底层用的那个），不辐射到你 log.New 出来的实例，也不影响其他包自己 new 的 logger。

好了，本文到此结束，带大家了解了《Golang自定义日志格式与SetFlags使用技巧》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多Golang知识！