使用标准库log包可快速搭建Go日志系统，支持前缀、时间戳和文件行号输出；通过SetOutput将日志写入文件便于持久化；借助log.New实现Info、Warn、Error分级管理；结合lumberjack实现日志轮转，提升生产环境可用性与可维护性。
在Go语言项目中，一个基础但可靠的日志系统是必不可少的。它能帮助开发者追踪程序运行状态、排查错误和监控服务健康。Golang标准库中的 log 包已经提供了基本的日志功能，结合一些简单设计就能快速搭建出实用的日志系统。
使用标准库 log 包记录基础日志
Go 的 log 包开箱即用，适合中小型项目或学习用途。你可以用它输出带时间戳的信息、警告和错误。
示例代码：
package main
import (
"log"
"os"
)
func main() {
// 设置日志前缀和标志（包含文件名和行号）
log.SetPrefix("[APP] ")
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.Println("应用启动")
log.Printf("处理用户ID: %d", 1001)
// 模拟错误
if err := someOperation(); err != nil {
log.Printf("操作失败: %v", err)
}
}
func someOperation() error {
return os.ErrNotExist
}
说明：
SetPrefix 添加日志前缀便于识别来源；
LstdFlags 包含日期和时间；
Lshortfile 显示调用日志的文件名和行号，对调试很有帮助。
将日志写入文件而非终端
生产环境中通常需要把日志保存到文件以便后续分析。只需将 log.SetOutput() 指向一个文件即可。
立即学习“go语言免费学习笔记（深入）”；
示例：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatalf("无法打开日志文件: %v", err)
}
defer file.Close()
log.SetOutput(file)
log.Println("这条日志会写入文件")
这样所有通过 log.Print/Printf/Println 输出的内容都会追加到 app.log 中。
按级别分类日志（Info、Warn、Error）
标准库没有原生支持日志级别，但可以通过自定义 logger 实现简易分级。
做法：创建不同前缀的 logger 实例。
infoLog := log.New(file, "[INFO] ", log.LstdFlags|log.Lshortfile)
warnLog := log.New(file, "[WARN] ", log.LstdFlags|log.Lshortfile)
errorLog := log.New(file, "[ERROR] ", log.LstdFlags|log.Lshortfile)
infoLog.Println("用户登录成功")
warnLog.Println("配置项缺失，使用默认值")
errorLog.Printf("数据库连接失败: %v", err)
这种方式结构清晰，便于后期用脚本或工具按级别过滤日志。
考虑后期扩展性与性能
对于高并发或大型服务，标准库 log 可能满足不了需求。可以考虑以下方向升级：
- 使用第三方库如 zap（Uber）、zerolog，它们性能更高，支持结构化日志
- 添加日志轮转机制（按大小或时间切割），可用 lumberjack 配合 log 包实现
- 在多 goroutine 场景下确保日志写入线程安全（标准 log 包本身是安全的）
例如结合 lumberjack 切割日志：
import "gopkg.in/natefinch/lumberjack.v2"
log.SetOutput(&lumberjack.Logger{
Filename: "logs/app.log",
MaxSize: 10, // MB
MaxBackups: 5,
MaxAge: 7, // 天
Compress: true,
})
基本上就这些。用好标准库的 log 包，再根据实际需求逐步增强，就能构建出稳定的基础日志系统。不复杂但容易忽略细节，比如时间戳、文件位置、错误上下文等，都值得认真设计。
