Go语言中使用标准log包可实现日志记录,支持Print、Panic、Fatal等输出方式;通过SetPrefix和SetFlags可自定义前缀与格式,如添加时间、文件名;利用SetOutput将日志写入文件;通过log.New创建多个独立Logger用于不同级别;适用于多数场景,复杂需求可选第三方库。

在Go语言开发中,记录日志是调试程序、监控运行状态和排查问题的重要手段。Golang标准库中的 log 包提供了基础的日志功能,使用简单且无需引入第三方依赖。下面总结几种常见的日志记录方法。
使用标准 log 包输出日志
Go 的 log 包默认将日志输出到标准错误(stderr),支持设置前缀、时间戳等格式信息。
基本用法如下:
- log.Print / log.Println / log.Printf:输出普通日志信息
- log.Panic:输出日志后触发 panic
- log.Fatal:输出日志后调用 os.Exit(1)
示例代码:
立即学习“go语言免费学习笔记(深入)”;
package main
import "log"
func main() {
log.Println("这是一条普通日志")
log.Printf("用户 %s 登录失败", "alice")
// log.Fatal("程序终止")
}
自定义日志前缀和格式
通过 log.SetPrefix 和 log.SetFlags 可以调整日志的显示格式。
- log.Ldate:日期(2009/01/23)
- log.Ltime:时间(01:23:23)
- log.Lmicroseconds:微秒级时间
- log.Llongfile:完整文件名和行号
- log.Lshortfile:仅文件名和行号
- log.LUTC:使用 UTC 时间
设置示例:
log.SetPrefix("[INFO] ")
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.Println("带时间和文件位置的信息")
输出类似:
[INFO] 2025/04/05 10:20:30 main.go:10: 带时间和文件位置的信息
将日志写入文件
默认输出到 stderr,可通过 log.SetOutput 修改输出目标。
将日志写入文件的常见做法:
file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatal("无法打开日志文件:", err)
}
defer file.Close()
log.SetOutput(file)
log.Println("这条日志会写入文件")
适合长时间运行的服务程序,便于后续分析。
创建多个日志器(Logger)
使用 log.New 可创建独立的日志器,适用于不同模块或级别。
warnLogger := log.New(os.Stderr, "[WARN] ", log.LstdFlags)
errorLogger := log.New(os.Stderr, "[ERROR] ", log.LstdFlags)
warnLogger.Println("警告:配置加载异常")
errorLogger.Println("错误:数据库连接失败")
每个 Logger 可独立设置输出目标和格式,提高灵活性。
基本上就这些。标准库 log 虽然功能简洁,但在多数场景下已足够使用。对于更复杂需求(如按级别切割、异步写入),可考虑 zap、logrus 等第三方库。但理解原生 log 的使用是基础。










