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() 快速改进:
立即学习“go语言免费学习笔记(深入)”;
-
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)确保不丢失,再恢复原输出
不复杂但容易忽略。










