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 参数。
立即学习“go语言免费学习笔记(深入)”;
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。









