使用 zap 等结构化日志库配置多环境日志级别，并结合 pprof 性能分析与 dlv 调试工具提升 Go 项目可观测性和问题定位效率。
在Go项目中配置日志和调试工具，关键在于选择合适的日志库、设置合理的日志级别，并结合调试工具快速定位问题。下面介绍常用的实践方式。
使用标准库 log 或更强大的
第三方日志库
第三方日志库Go 的标准库 log 包可以满足基本的日志输出需求：
- 支持输出到控制台或文件
- 可添加时间戳、文件名和行号
- 简单易用，无需引入外部依赖
示例：
log.SetFlags(log.LstdFlags | log.Lshortfile)
log.Println("这是一条普通日志")
但生产环境推荐使用功能更强的第三方库，比如：
- zap（Uber）：高性能结构化日志，适合高并发场景
- logrus：功能丰富，支持结构化日志，API 友好
- slog（Go 1.21+ 内置）：官方推出的结构化日志包，轻量且现代
以 zap 为例：
logger, _ := zap.NewProduction()
defer logger.Sync()
logger.Info("用户登录", zap.String("user", "alice"))
配置不同环境下的日志级别
开发环境通常需要详细日志，生产环境则应减少冗余信息。可通过环境变量控制日志级别：
- Debug 级别用于开发时追踪流程
- Info 记录关键操作
- Warn 和 Error 用于异常但非崩溃的情况
例如使用 zap 配合 viper 读取配置：
var cfg zap.Config
if env == "dev" {
cfg = zap.NewDevelopmentConfig()
} else {
cfg = zap.NewProductionConfig()
}
logger, _ := cfg.Build()
启用调试工具：pprof 和 delve
Go 自带 net/http/pprof，可用于分析程序性能：
import _ "net/http/pprof"
go func() {
log.Println(http.ListenAndServe("localhost:6060", nil))
}()
启动后访问 http://localhost:6060/debug/pprof/ 可查看 CPU、内存、goroutine 等信息。
调试代码逻辑推荐使用 delve（dlv）：
- 安装：go install github.com/go-delve/delve/cmd/dlv@latest
- 启动调试：dlv debug main.go
- 支持断点、变量查看、单步执行等常见调试功能
在 VS Code 中配合 launch.json 使用 dlv，体验接近 IDE 级别的调试。
小技巧：开发时结合日志与调试
开发阶段可以在关键函数插入调试日志，比如：
log.Printf("进入处理函数，参数: %+v", req)
或使用 zap.DPanicf 在开发时触发警告。
同时开启 dlv 调试，能更快定位数据流转中的问题。
基本上就这些。合理配置日志输出，再搭配 pprof 和 dlv，Go 的可观测性和调试效率会大幅提升。
