在Golang开发中，日志收集与输出是程序调试和运行监控的基础能力，标准库自带的log包已经能够满足大部分基础场景的需求，不需要额外引入第三方依赖就可以实现日志的打印、格式自定义和文件持久化。
Golang标准log包基础用法
Golang的log包提供了默认的日志输出实例，默认会将日志输出到标准错误流，并且会自动添加时间戳前缀。我们可以通过简单的代码实现基础的日志输出：
package main
import (
"log"
)
func main() {
// 输出普通日志
log.Println("这是一条普通日志信息")
// 输出格式化日志
name := "test"
log.Printf("当前用户名称是: %sn", name)
// 输出错误日志并终止程序
log.Fatal("这是一条致命错误日志，程序会退出")
}
自定义日志前缀和标志
默认的日志输出可能不符合我们的需求，log包允许我们自定义日志的前缀和输出的标志位，比如是否显示文件名、行号等信息：
package main
import (
"log"
"os"
)
func main() {
// 创建自定义日志实例
myLogger := log.New(os.Stdout, "MY_LOG: ", log.Ldate|log.Ltime|log.Lshortfile)
// 输出自定义日志
myLogger.Println("这是自定义格式的日志")
myLogger.Printf("自定义日志支持格式化输出: %dn", 100)
}
上面的代码中，log.New函数的第一个参数是日志输出的目标，这里设置为标准输出流；第二个参数是日志的前缀；第三个参数是标志位，log.Ldate表示显示日期，log.Ltime表示显示时间，log.Lshortfile表示显示短文件名和行号。
实现日志文件收集
实际开发中我们通常需要把日志输出到文件中，方便后续查看和排查问题，只需要把日志输出的目标设置为文件即可：
package main
import (
"log"
"os"
)
func main() {
// 打开或创建日志文件，权限为0666，如果文件不存在则创建，存在则追加写入
logFile, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatal("打开日志文件失败: ", err)
}
defer logFile.Close()
// 创建日志实例，输出目标为日志文件
fileLogger := log.New(logFile, "FILE_LOG: ", log.Ldate|log.Ltime|log.Lshortfile)
// 写入日志到文件
fileLogger.Println("这是写入日志文件的测试内容")
fileLogger.Printf("当前时间戳: %vn", os.Getpid())
}
日志分级简单实现
基础的log包没有内置日志分级功能，我们可以通过封装的方式实现简单的日志分级，比如区分INFO、WARN、ERROR等级别：
package main
import (
"log"
"os"
)
// 定义日志级别
const (
INFO = "INFO"
WARN = "WARN"
ERROR = "ERROR"
)
type MyLogger struct {
logger *log.Logger
}
// 初始化自定义日志
func NewMyLogger(file *os.File) *MyLogger {
return &MyLogger{
logger: log.New(file, "", log.Ldate|log.Ltime),
}
}
// 输出INFO级别日志
func (m *MyLogger) Info(msg string) {
m.logger.Printf("[%s] %sn", INFO, msg)
}
// 输出WARN级别日志
func (m *MyLogger) Warn(msg string) {
m.logger.Printf("[%s] %sn", WARN, msg)
}
// 输出ERROR级别日志
func (m *MyLogger) Error(msg string) {
m.logger.Printf("[%s] %sn", ERROR, msg)
}
func main() {
logFile, err := os.OpenFile("level.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatal("打开日志文件失败: ", err)
}
defer logFile.Close()
myLogger := NewMyLogger(logFile)
myLogger.Info("这是一条信息日志")
myLogger.Warn("这是一条警告日志")
myLogger.Error("这是一条错误日志")
}
注意事项
- log包的
Fatal系列方法会在输出日志后调用os.Exit(1)终止程序，使用时需要注意场景。 - 多协程场景下log包的日志实例是线程安全的，可以放心在多个协程中同时使用同一个日志实例输出日志。
- 如果需要更复杂的日志功能，比如日志切割、异步输出等，可以考虑使用zap、logrus等第三方日志库，基础场景使用标准log包即可。
通过上述示例，我们可以完成Golang中基础的日志收集与输出功能，满足日常开发中的大部分基础日志需求，根据实际场景调整日志的输出目标、格式和分级即可。