用log包写文件日志需用os.OpenFile指定os.O_APPEND|os.O_CREATE|os.O_WRONLY标志创建文件,复用log.Logger实例,避免覆盖或失败;可全局SetOutput重定向,但须在首次log.Print*前调用;按级别分流需多个独立logger绑定不同文件;不推荐fmt.Fprintln因缺失时间戳、行号、并发安全等特性。

用 log 包写最简日志到文件
Go 标准库的 log 包开箱即用,但默认输出到 os.Stderr,要存文件得手动替换输出目标。常见错误是直接传入 os.OpenFile 返回的 *os.File 却没设 os.O_APPEND | os.O_CREATE | os.O_WRONLY 标志,导致日志覆盖或写入失败。
实操建议:
- 用
os.OpenFile时必须显式指定标志位,推荐组合:os.O_APPEND | os.O_CREATE | os.O_WRONLY - 日志对象应复用,不要每次写都新建
log.New实例 - 记得在程序退出前调用
file.Close()(或用defer)
file, err := os.OpenFile("app.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
if err != nil {
log.Fatal(err)
}
defer file.Close()
logger := log.New(file, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
logger.Println("服务启动完成")
用 log.SetOutput 全局重定向标准日志
如果项目里大量用了 log.Println、log.Printf 等顶层函数,又不想逐个替换成自定义 logger,可以用 log.SetOutput 统一接管。注意:它只影响标准包的全局 logger,不影响你用 log.New 创建的独立实例。
容易踩的坑:
立即学习“go语言免费学习笔记(深入)”;
- 调用
log.SetOutput必须在任何log.Print*调用之前,否则部分日志仍会输出到 stderr - 若同时用多个日志文件(比如 info.log 和 error.log),不能靠
SetOutput分流,得自己封装判断逻辑 - 多 goroutine 写同一文件安全,因为
log包内部加了锁
file, _ := os.OpenFile("info.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
log.SetOutput(file)
log.Println("这条会进 info.log") // ✅
log.Printf("时间:%v", time.Now()) // ✅
按级别分流日志:info / warn / error 到不同文件
标准 log 包不内置级别概念,所谓 “level” 是靠不同 logger 实例 + 前缀模拟的。关键点在于:每个级别对应一个独立的 *log.Logger,且各自绑定不同的 io.Writer(即文件句柄)。
性能与兼容性提醒:
- 每个文件打开一次即可,别为每条日志都
OpenFile - 不要用
os.Stdout或os.Stderr混合写入多个文件,它们不是线程安全的跨文件目标 - 若后续想升级到
zap或zerolog,这种前缀式 level 设计基本可平滑迁移
infoFile, _ := os.OpenFile("info.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
warnFile, _ := os.OpenFile("warn.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
errorFile, _ := os.OpenFile("error.log", os.O_APPEND|os.O_CREATE|os.O_WRONLY, 0644)
InfoLogger := log.New(infoFile, "[INFO] ", log.Ldate|log.Ltime|log.Lshortfile)
WarnLogger := log.New(warnFile, "[WARN] ", log.Ldate|log.Ltime|log.Lshortfile)
ErrorLogger := log.New(errorFile, "[ERROR] ", log.Ldate|log.Ltime|log.Lshortfile)
InfoLogger.Println("配置加载成功")
WarnLogger.Printf("忽略无效配置项:%s", "timeout_ms")
ErrorLogger.Fatalln("数据库连接失败")
为什么不用 fmt.Fprintln 直接写文件?
有人图省事用 fmt.Fprintln(file, msg) 替代 log 包,短期能跑,但很快会暴露问题:没有时间戳、没有调用位置(log.Lshortfile)、不支持自动加前缀、并发写时不带锁、无法统一设置格式。尤其当需要排查线上问题时,缺失 log.Lshortfile 导致根本不知道哪行代码打了日志。
所以哪怕只是临时脚本,也建议走 log.New 流程 —— 多写三行初始化代码,换来的是可维护性和排障效率。
真正复杂的地方不在“怎么写进去”,而在“怎么让日志既不丢、不错序、不阻塞主流程、还能按需轮转”。基础示例只解决前半截,后面得靠 lumberjack 或直接切到结构化日志库。










