Go 标准库 log 包适合轻量级日志,但不支持分级、异步、轮转;可通过 SetOutput、SetFlags、SetPrefix 自定义输出目标和格式;log.Printf 不自动换行,log.Print/Println 会;log.Fatal 退出进程,log.Panic 触发 panic;其三大硬伤是无级别、无 JSON、无轮转,生产环境应选 zap 或 zerolog。

Go 标准库 log 包适合轻量级日志记录,但默认不支持分级、异步写入或自动轮转——直接用 log.Println 或 log.Printf 会输出到 stderr,且无法关闭时间戳或修改前缀。
如何自定义 log 输出目标和格式
默认日志写入 os.Stderr,可通过 log.SetOutput 指向文件、io.MultiWriter 或自定义 io.Writer。同时用 log.SetFlags 控制时间戳、文件名、行号等前缀;用 log.SetPrefix 添加固定前缀。
-
log.SetFlags(log.Ldate | log.Ltime):只保留日期和时间,去掉文件/行号 -
log.SetFlags(0):完全禁用所有前缀(包括时间) - 若写入文件,需确保
*os.File已打开且未被关闭,否则后续log.Print会 panic
file, _ := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
log.SetOutput(file)
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
log.Println("服务启动")
为什么 log.Printf 不打印换行符而 log.Print 会
log.Print 和 log.Println 内部自动追加换行符;log.Printf 不加——它严格按格式字符串输出,换行必须显式写 "\n"。这是设计使然,不是 bug。
- 误用
log.Printf("error: %v", err)后续日志可能挤在同一行 - 正确做法是
log.Printf("error: %v\n", err)或直接用log.Printf("error: %v", err)+ 单独log.Print补换行 - 更稳妥的是统一用
log.Println配合fmt.Sprintf拼接消息
log.Fatal 和 log.Panic 的真实行为差异
三者都调用 log.Output 输出日志,但后续动作不同:log.Fatal 调用 os.Exit(1);log.Panic 触发 panic;log.Print 纯输出无副作用。
立即学习“go语言免费学习笔记(深入)”;
-
log.Fatal("db init failed")→ 日志输出后进程立即退出,defer 不执行 -
log.Panic("config missing")→ 日志输出后 panic,仍会执行已注册的 defer - 在 main 函数中用
log.Fatal常见,但在 goroutine 中应避免,否则可能静默终止协程而不报错
标准 log 包不适合生产环境的三个硬伤
它没有日志级别(info/warn/error)、不支持 JSON 输出、无法按大小或时间轮转文件——这些不是配置问题,而是 API 层面缺失。
- 想加 level,只能自己封装
log.New多个实例,但无法共用输出目标或前缀设置 - 想写 JSON,得手动序列化再传给
log.Print,丢失结构化能力 - 轮转需依赖第三方库(如
gopkg.in/natefinch/lumberjack.v2),且要小心lumberjack.Logger的Close调用时机
如果项目需要分级、上下文字段或日志采集对接,应该直接切换到 zap 或 zerolog,而不是在 log 上打补丁。










