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

来到golang学习网的大家，相信都是编程学习爱好者，希望在这里学习Golang相关编程知识。下面本篇文章就来带大家聊聊《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学习网！更多关于Golang的相关知识，也可关注golang学习网公众号。