Golang log日志使用与管理技巧

Go标准库的log包虽轻量易用，但默认缺乏日志分级、文件输出和自动轮转等关键能力；本文深入剖析其默认行为（如固定时间戳、强制换行、stderr输出），并手把手教你通过SetPrefix/SetFlags定制前缀与格式、用SetOutput重定向至文件或MultiWriter实现多端输出、再以简洁结构体封装轻松支持INFO/WARN/ERROR级别——无需引入第三方库，即可让标准log在中小型项目初期发挥最大价值，为后续平滑升级到zap或zerolog打下坚实基础。

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：

• 写入文件：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 更合适。

理论要掌握，实操不能落！以上关于《Golang log日志使用与管理技巧》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！