在go项目中实现日志记录功能有多种方案，具体选择取决于项目需求。对于小型项目或快速开发，可使用标准库log，它简单易用但不支持日志级别和灵活配置；若需要结构化日志和分级输出，推荐使用logrus，它支持json格式、日志级别设置及输出到文件或远程服务器；对性能要求较高的高并发项目可选用zap，其写入速度快，支持结构化字段和标准化输出；若追求轻量级结构化日志，则可尝试zerolog。无论选择哪种方案，都建议统一封装日志调用方式以便后期维护和替换。
在 Go 项目中实现日志记录功能，其实并不复杂。Go 标准库自带了 log 包，可以满足基础的日志需求。但如果你需要更丰富的功能，比如分级日志、输出到文件、支持 JSON 格式等，就需要引入第三方日志库，比如 logrus、zap 或 zerolog。
下面我们就来看看几种常见的做法，帮助你根据实际场景选择合适的日志方案。
使用标准库 log 实现基础日志记录
Go 自带的 log 包使用简单，适合小型项目或者快速开发。
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"log"
"os"
)
func main() {
// 输出到控制台
log.Println("这是一条普通日志")
// 输出到文件
file, _ := os.Create("app.log")
log.SetOutput(file)
log.Println("这条日志会被写入文件")
}优点：
- 不需要额外依赖
- 简单易用
缺点：
- 不支持日志级别（info/warn/error）
- 无法灵活配置输出格式和路径
如果只是调试或轻量级服务，直接用标准库就够了。但一旦项目变大，还是建议换更强大的日志库。
用 logrus 实现结构化日志
logrus 是一个非常流行的日志库，支持结构化日志、多级输出等特性。
安装方式：
go get github.com/sirupsen/logrus
基本用法示例：
package main
import (
log "github.com/sirupsen/logrus"
)
func main() {
// 设置日志格式为 JSON，默认是 text
log.SetFormatter(&log.JSONFormatter{})
// 记录不同级别的日志
log.WithFields(log.Fields{
"animal": "walrus",
}).Info("信息日志")
log.Warn("警告信息")
log.Error("错误信息")
}常用配置点：
- 日志级别设置：
log.SetLevel(log.DebugLevel) - 输出到文件：
log.SetOutput(os.Stderr) - 支持 hook，可将日志发送到远程服务器
logrus 的优势在于它既保持了简洁性，又提供了不错的扩展能力，适合大多数中型项目。
高性能日志 zap 的使用技巧
如果你对性能要求较高，比如高并发服务、微服务，那么 zap 是个不错的选择。它由 Uber 开发，专为高性能设计。
安装方式：
go get go.uber.org/zap
基本使用：
package main
import (
"go.uber.org/zap"
)
func main() {
logger, _ := zap.NewProduction()
defer logger.Sync()
logger.Info("这是一个 info 日志",
zap.String("method", "GET"),
zap.Int("status", 200),
)
}特点：
- 极快的写入速度
- 支持结构化日志字段
- 提供 SugaredLogger 接口，便于过渡使用
- 默认输出 JSON 格式
不过 zap 的学习成本略高于 logrus，API 设计也更偏向“严谨”，更适合追求性能和标准化输出的项目。
如何选择适合你的日志库？
-
项目小、不需要复杂功能？ → 用标准库
log -
需要结构化日志 + 分级输出？ → 用
logrus -
追求极致性能 + 高并发？ → 用
zap -
想要最轻量结构化？ → 可以试试
zerolog
选好之后，记得统一封装一下日志调用方式，方便后期替换或者统一处理。比如定义一个 logger 接口，在多个模块中注入使用。
基本上就这些。日志虽然看起来简单，但合理配置后能大大提升排查问题的效率，别等到出问题才想起来加日志。
