在 Ubuntu 环境下为 Golang 项目构建日志系统,其实有很多方案可供选择。最直接的方式是使用标准库 log 包,轻量且零依赖;如果项目对日志级别、结构化输出有更高要求,那么 logrus、zap 这类第三方库会更加顺手。下面先从标准库说起。

标准库 log 的配置主要分三步:
设置日志输出:默认是控制台,但你可以同时写入文件,或者用
io.MultiWriter组合多个目标。自定义日志格式:时间戳、文件名、行号这些都可以控制,通过
SetFlags调整即可。模拟日志级别:标准库本身没有级别概念,但可以借助前缀变通实现——比如用不同前缀区分 INFO、ERROR。
下面是一个实际例子,这段代码将日志同时输出到控制台和 app.log 文件,并设置了日期、时间和调用位置信息:
package main
import (
"io"
"log"
"os"
)
func main() {
// 创建日志文件
logFile, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
log.Fatalf("error opening log file: %v", err)
}
defer logFile.Close()
// 同时输出到文件和控制台
log.SetOutput(io.MultiWriter(logFile, os.Stdout))
// 设置前缀和标志
log.SetPrefix("INFO: ")
log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)
// 写入日志
log.Println("This is an informational message.")
log.Printf("This is a formatted %s message.", "info")
// 切换前缀表示错误级别
log.SetPrefix("ERROR: ")
log.Println("This is an error message.")
}
可以看到,通过切换前缀就能简单区分不同严重程度的日志。虽然不如原生级别库方便,但胜在无需引入额外依赖。
当然,标准库只能做到这个程度。如果项目需要真正的日志级别、结构化输出(比如 JSON 格式)、字段绑定等能力,那么第三方库是更好的选择。logrus 就是其中非常成熟的一个。下面是用它记录带字段的结构化日志的典型用法:
package main
import (
"os"
"github.com/sirupsen/logrus"
)
func main() {
logger := logrus.New()
logger.SetOutput(os.Stdout)
logger.SetFormatter(&logrus.JSONFormatter{})
logger.SetLevel(logrus.InfoLevel)
logger.Info("This is an informational message.")
logger.WithFields(logrus.Fields{
"animal": "walrus",
"size": 10,
}).Info("A group of walrus emerges from the ocean")
logger.WithFields(logrus.Fields{
"omg": true,
"number": 100,
}).Error("The ice breaks!")
}
使用前记得用 go get 安装:
go get github.com/sirupsen/logrus
安装完成后,结合官方文档的说明就能快速上手了——logrus 的字段绑定、Hook 机制、多输出格式都很成熟,适合中大型项目。如果追求极致性能,也可以考虑 zap,它在高并发场景下表现更优。总之,根据项目实际需求选择最适合的那一个就好。
