Go 标准库 log 包轻量易用但默认不支持分级、文件输出或轮转;其日志写入 os.Stderr,带固定时间戳和换行,可通过 SetPrefix/SetFlags 自定义前缀与格式,SetOutput 重定向至文件或 MultiWriter,封装结构体可实现级别方法,适合中小型项目初期使用。

Go 标准库 的 log 包轻量、易用,适合基础日志需求,但默认不支持分级、文件输出或自动轮转。想用好它,关键在于理解其默认行为,并通过简单封装提升实用性。
理解 log 默认输出行为
默认情况下,log.Println 或 log.Printf 会将日志写入 os.Stderr,带时间戳(精确到秒)和换行符。它不区分日志级别,也不支持异步或缓冲。
- 时间格式固定,不可关闭:如
2024/05/20 14:22:36 message - 每条日志末尾自动加换行,不能省略
- 不支持 INFO/WARN/ERROR 等级别标识,需手动添加前缀
自定义日志前缀与标志位
使用 log.SetPrefix 和 log.SetFlags 可增强可读性:
-
log.SetPrefix("[APP]")统 一加 模块标识 -
log.SetFlags(log.Ldate | log.Ltime | log.Lmicroseconds | log.Lshortfile)启用微秒级时间 + 文件名 + 行号 - 避免使用
log.LUTC(除非明确需要 UTC 时间),本地时区更符合运维习惯
重定向日志到文件或自定义 Writer
只需把 os.File 或任意 io.Writer 传给 log.SetOutput:
立即学习“go 语言免费学习笔记(深入)”;
- 写入文件:
f, _ := os.OpenFile("app.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644); log.SetOutput(f) - 同时输出到控制台和文件?用
io.MultiWriter(os.Stdout, f) - 注意:文件句柄需在程序退出前
defer f.Close(),否则可能丢失最后几条日志
简单封装支持日志级别(无需第三方库)
用结构体包装 *log.Logger,实现 Info/Warn/Error 方法:
- 每个方法内部调用
log.Printf,并前置对应级别字符串,如[INFO] - 错误级别可额外调用
log.Print("error occurred:", err)避免丢失原始 error 文本 - 不建议在封装中做并发控制(标准
log.Logger本身是安全的),但可加简单锁用于自定义 writer 场景
基本上就这些。标准 log 足够支撑中小型项目初期日志需求,真正需要结构化、分级、轮转或上下文追踪时,再平滑迁移到 zap 或 zerolog 更合适。