Go自定义log.Logger前缀与输出方法

Go 标准库的 `log.Logger` 虽轻量却暗藏诸多易踩坑细节：前缀必须通过 `SetPrefix` 在首次写入前显式设置，不能靠字符串拼接，且不自动补空格或支持动态格式；输出目标（如 `os.Stdout`/`os.Stderr`/文件/内存）必须明确传入 `log.New`，缺省即 panic；日志标志位（`Flags`）决定时间戳、文件行号等元信息是否呈现，而并发写入时 writer 的线程安全性更需格外关注——看似简单的日志配置，实则处处是影响可维护性、可观测性与稳定性的关键决策点。

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 或内联函数里可能返回意外位置——这些细节不试一次根本意识不到。

今天带大家了解了的相关知识，希望对你有所帮助；关于Golang的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~