如何使用Golang log包记录日志_Golang日志输出方式

8次阅读

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

如何使用Golang log包记录日志_Golang日志输出方式

Go 标准库 log 包适合轻量级日志记录,但默认不支持分级、异步写入或自动轮转——直接用 log.Printlnlog.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.Printlog.Println 内部自动追加换行符;log.Printf 不加——它严格按格式字符串输出,换行必须显式写 "n"。这是设计使然,不是 bug

  • 误用 log.Printf("Error: %v", err) 后续日志可能挤在同一行
  • 正确做法是 log.Printf("error: %vn", 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.LoggerClose 调用时机

如果项目需要分级、上下文字段或日志采集对接,应该直接切换到 zapzerolog,而不是在 log 上打补丁。

text=ZqhQzanResources