使用标准库log记录错误并结合Errors包增强上下文，生产环境推荐zap等结构化日志库，统一封装实现高效错误追踪。

在go语言中记录错误信息是开发过程中非常重要的一环，良好的日志系统能帮助快速定位问题。golang本身没有内置复杂的日显功能，但可以通过标准库和第三方包高效实现错误日志记录。

使用标准库 log 记录错误

Go的log包是最基础的日志工具，适合简单项目。当发生错误时，配合if err != nil判断进行记录。

示例：

package main
import (
    “log”
    “os”
)

func main() {
    file, err := os.Open(“nonexistent.txt”)
    if err != nil {
        log.printf(“打开文件失败: %v”, err)
        return
    }
    defer file.Close()
}

说明：log.Printf会自动加上时间戳，输出格式清晰。若要写入文件而非控制台，可用log.SetOutput()重定向。

立即学习“go语言免费学习笔记（深入）”；

结合 errors 包增强错误信息

标准库的errors.New或fmt.Errorf可用于包装错误，提供更多上下文。

示例：

if err != nil {
    log.Printf(“数据库查询失败: %w”, err)
}

使用%w可保留原始错误链，便于后续用errors.Is或errors.As分析。

如知AI笔记

如知笔记——支持markdown的在线笔记，支持ai智能写作、AI搜索，支持DeepseekR1满血大模型

27

查看详情

使用第三方日志库（如 zap 或 logrus）

对于生产环境，推荐使用高性能结构化日志库，例如 Uber 的 zap。

安装：

go get go.uber.org/zap

使用示例：

import (
    “go.uber.org/zap”
)

func main() {
    logger, _ := zap.NewProduction()
    defer logger.Sync()

    if err != nil {
        logger.Error(“请求处理失败”,
            zap.String(“url”, “/api/v1/data”),
            zap.Error(err),
        )
    }
}

优势：支持结构化输出（jsON），便于接入elk等日志系统，性能高，级别控制明确（Debug、Info、Error等）。

统一错误日志处理建议

实际项目中可建立统一的日志封装，比如：

• 定义全局 logger 实例
• 错误发生时记录堆栈（zap 提供 Caller 和 Stacktrace）
• 敏感信息脱敏后再记录
• 按模块区分日志输出路径

基本上就这些。从标准库起步，逐步过渡到结构化日志，能让错误追踪更高效。关键是：及时记录、保留上下文、结构清晰。