Go语言log包提供轻量级日志功能,支持默认输出到stderr、自定义格式与输出目标,并可创建多个Logger实例用于模块化管理,适用于中小型项目。

Go语言标准库中的log包提供了简单而有效的日志记录功能,适用于大多数中小型项目。虽然它不像第三方库(如zap或logrus)那样功能丰富,但其轻量、无需依赖的特性使其成为初学者和简洁项目的理想选择。
基本用法:使用标准log输出日志
Go的log包默认将日志输出到标准错误(stderr),你可以直接调用其全局函数进行记录:
- log.Print / log.Printf / log.Println:输出普通日志信息
- log.Fatal / log.Fatalf / log.Fatalln:输出日志后调用os.Exit(1)
- log.Panic / log.Panicf / log.Panicln:输出日志后触发panic
示例代码:
package main
import "log"
func main() {
log.Println("这是一条普通日志")
log.Printf("带格式的日志: 用户 %s 登录", "alice")
// log.Fatal("致命错误,程序退出")
}
自定义日志前缀与输出目标
默认情况下,日志只包含时间戳和内容。你可以通过log.SetFlags和log.SetPrefix来自定义格式,并使用log.SetOutput更改输出位置(如写入文件)。
立即学习“go语言免费学习笔记(深入)”;
常用标志位:
- log.Ldate:日期(2006/01/02)
- log.Ltime:时间(15:04:05)
- log.Lmicroseconds:精确到微秒
- log.Llongfile:完整文件名和行号
- log.Lshortfile:仅文件名和行号
- log.LUTC:使用UTC时间
示例:设置带文件名和时间的日志格式并输出到文件:
package main
import (
"log"
"os"
)
func main() {
// 设置日志格式
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.SetPrefix("[INFO] ")
// 输出到文件
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创建自定义Logger实例:
authLog := log.New(os.Stdout, "[AUTH] ", log.LstdFlags|log.Lshortfile)
dbLog := log.New(os.Stdout, "[DB] ", log.LstdFlags|log.Lshortfile)
authLog.Println("用户认证开始")
dbLog.Println("数据库连接成功")
每个Logger可独立设置输出目标、前缀和标志,便于模块化管理。
生产环境注意事项
虽然log包足够简单,但在生产环境中需注意以下几点:
- 确保日志文件有适当的轮转机制(可通过外部工具如logrotate实现)
- 避免在高并发场景下频繁写日志导致性能瓶颈
- 敏感信息(如密码、token)不应明文记录
- 调试日志建议在生产中关闭,可通过配置控制级别
若需要结构化日志、日志级别控制或高性能输出,推荐结合zap或slog(Go 1.21+)等更现代的日志库。
基本上就这些。Golang的log包虽简单,但合理使用足以支撑多数场景下的日志需求。掌握其基本用法和定制方式,是Go开发者必备技能之一。不复杂但容易忽略细节,比如输出目标和格式设置,实际项目中应尽早规范。










