必须用SetPrefix设置前缀,不能拼接字符串;它仅作用于默认logger开头固定部分,需首次写入前调用,且不自动加空格。

log.Logger 的前缀设置必须用 SetPrefix,不能靠拼接字符串
Go 标准库的 log.Logger 不支持在每次调用 Print/Printf 时动态加前缀。你写 logger.Printf("[INFO] %s", msg) 看似可行,但会破坏日志结构一致性,且无法被统一开关或过滤。真正可控的方式是调用 SetPrefix —— 它只影响后续输出的**开头固定部分**,不干扰时间戳、换行等默认行为。
注意:SetPrefix 不会影响已创建的子 logger(比如用 log.New 新建的另一个实例),也不会改变底层 writer 的行为。
-
SetPrefix必须在首次写入前调用才生效;若 logger 已输出过内容,前缀可能不显示(尤其在非缓冲 writer 下) - 前缀不会自动加空格或冒号,
logger.SetPrefix("[DEBUG]")输出形如[DEBUG]2024/05/12 10:30:45 message,建议手动加空格:"[DEBUG] " - 前缀是字符串字面量,不支持格式化;想实现带模块名的前缀(如
[http] [INFO]),得用多个 logger 实例或封装函数
输出目标必须显式指定,os.Stdout 不是默认值
很多人误以为 log.Logger 默认输出到控制台,其实不然:log.New 的第一个参数是 w io.Writer,必须明确传入,否则 panic。标准库里的全局 log 包(如 log.Printf)才默认用 os.Stderr。
常见错误是传 nil 或忘记初始化,导致运行时报 panic: runtime error: invalid memory address。
- 写到标准输出:用
os.Stdout;写到标准错误(推荐用于警告/错误):用os.Stderr - 写到文件需提前
os.Create或os.OpenFile,并确保关闭——log.Logger本身不管理文件生命周期 - 写到内存(如测试)可用
bytes.Buffer,但要注意并发安全:多个 goroutine 同时写需加锁或用sync.Mutex包装 writer
日志标志位(Flags)决定时间、文件名、行号是否出现
log.New 的第三个参数是 flag,它控制每条日志的元信息格式。不设 flag 就只有纯消息体,没有时间戳,这在生产环境基本不可用。
常用组合有:log.LstdFlags(时间)、log.Lshortfile(文件名+行号)、log.Lmicroseconds(微秒级时间)。它们用按位或 | 拼接。
-
log.LstdFlags包含年月日、时分秒、毫秒,但不含时区;如需 UTC 或带时区,得自己实现 writer 包装器 -
log.Lshortfile和log.Llongfile都基于runtime.Caller,有轻微性能开销;高吞吐场景慎用 - 自定义 flag(比如加 Git commit ID)无法通过标准 flag 实现,必须替换 writer 或封装日志函数
并发写日志要小心 writer 是否线程安全
log.Logger 自身是并发安全的,但它的 writer 不一定。例如 os.Stdout 和 os.Stderr 是线程安全的,而 bytes.Buffer、os.File(某些系统)或自定义 writer 可能不是。
典型现象:多 goroutine 调用同一个 logger 写文件时,日志行错乱、截断或丢失。
- 最简单方案:用
sync.Mutex包一层 writer,但会成为性能瓶颈 - 更实用的是用
io.MultiWriter分发到多个目标,或直接切换到zap/zerolog等专为并发优化的日志库 - 如果坚持用标准库,确保所有写入都经由同一个 logger 实例(而非多个实例写同一文件)
前缀和输出目标是 log.Logger 最常配错的两个点,尤其是把 SetPrefix 当成格式化工具,或忽略 writer 初始化。flag 设置看起来简单,但 Lshortfile 在 CGO 或内联函数里可能返回意外位置——这些细节不试一次根本意识不到。


















