Golang日志系统：log包文件与控制台记录

本文深入解析了如何基于Go标准库的log包构建一个轻量实用的日志系统，重点解决其默认仅输出到stderr、缺乏日志级别和双输出支持等短板；通过io.MultiWriter实现文件与控制台同步写入，结合SetFlags/SetPrefix或自定义Logger添加时间戳（含ISO8601格式）、文件行号及语义化前缀，并封装Info/Warning/Error方法模拟日志分级；最后给出生产环境关键优化建议——引入bufio缓冲提升性能、实现线程安全的按日轮转，以及保障关键错误不丢失的兜底策略，让标准库也能撑起可靠日志需求。

Go 标准库的 log 包轻量、易用，但默认只输出到标准错误（stderr），不支持同时写文件和控制台，也不带日志级别、格式化时间等常用功能。要实现“文件 + 控制台”双输出日志系统，核心思路是：用 io.MultiWriter 将日志同时写入多个 io.Writer（如文件和 os.Stdout），再配合自定义格式器提升可读性。

基础双输出：用 MultiWriter 同时写文件和控制台

Go 的 log.SetOutput() 只接受一个 io.Writer，但我们可以用 io.MultiWriter 把多个 writer 合并成一个：

• 先创建日志文件（如 app.log），用 os.OpenFile 打开，设置 os.O_CREATE | os.O_APPEND | os.O_WRONLY
• 调用 io.MultiWriter(file, os.Stdout) 构造组合 writer
• 传给 log.SetOutput()，后续所有 log.Print/Printf/Println 都会同步输出到两者

注意：文件需手动关闭，建议在程序退出前用 defer file.Close()；若需按天轮转，需自行判断日期并重建文件句柄。

增强可读性：自定义日志前缀和时间格式

默认日志不带时间戳或模块标识，不利于排查。可通过 log.SetFlags() 和 log.SetPrefix() 快速改进：

• log.SetFlags(log.LstdFlags | log.Lshortfile)：启用标准时间 + 文件名+行号（LstdFlags 含日期、时间、微秒）
• log.SetPrefix("[INFO] ")：为每条日志加统一前缀（如 "[INFO]"、"[ERROR]"）
• 若需更灵活的时间格式（如 ISO8601），需封装自己的 Logger，用 time.Now().Format("2006-01-02 15:04:05") 拼接字符串后调用 log.Print()

区分日志级别：封装 Info/Warning/Error 方法

标准 log 包无级别概念，但可通过封装实现语义化调用：

• 定义三个全局 *log.Logger 实例：分别设置不同前缀（"[INFO] "、"[WARN] "、"[ERROR] "）和不同输出（例如 error 日志额外写入 os.Stderr）
• 每个实例调用 log.New(multiWriter, prefix, flags) 创建，复用同一底层 writer
• 对外提供 Infof(msg string, v ...interface{}) 等函数，内部调用对应 logger 的 Printf

这样既保持标准库简洁性，又获得类似第三方库（如 zap、logrus）的使用体验。

生产可用建议：避免阻塞与简单轮转

直接用 os.File 写日志在高并发下可能成为瓶颈，且不支持自动切割。简单但实用的优化方式：

• 使用 bufio.NewWriterSize(file, 4096) 包装文件 writer，减少系统调用次数
• 每日轮转可借助定时器（time.Ticker）检查当前日期，变化时关闭旧文件、打开新文件，并更新 MultiWriter 中的 writer（注意线程安全，建议加锁）
• 关键错误日志（如 panic）建议单独用 log.SetOutput(os.Stderr) 确保不丢失，再恢复原输出

不复杂但容易忽略。

以上就是《Golang日志系统：log包文件与控制台记录》的详细内容，更多关于的资料请关注golang学习网公众号！