Go 语言日志记录：初学者最佳实践

面向初学者的在线Python训练器

轻松学习Python，无需理论负担。在浏览器中直接解决带自动检查的实践任务，无需安装任何东西。

开始课程

Go 应用程序中的日志记录：初学者最佳实践

日志记录不仅仅是向控制台输出消息。在生产环境中，日志有助于跟踪错误、分析性能和理解系统行为。在本文中，我们将为初学者解析 Go (Golang) 中日志记录的最佳实践：从标准库到现代结构化方法。

为什么日志记录在 Go 中很重要？

Go 是一种用于创建高负载服务器应用程序的语言。没有高质量的日志记录，您将无法：

快速定位生产环境中的错误
理解故障时的事件顺序
进行安全审计
优化性能

良好的日志记录应该是：结构化的、分级的 (debug, info, warn, error)、上下文的（包含请求 ID、函数名）和可管理的（轮转、输出到文件）。

1. 从标准库 `log` 开始

Go 提供了内置的 log 包——简单且足以用于小型项目。它的工作方式如下：

package main

import (    "log"    "os")

func main() {    // 基本配置：输出到 stderr    log.SetOutput(os.Stderr)    log.SetPrefix("INFO: ")    log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)

    log.Println("应用程序已启动")    log.Printf("用户 %s 已授权", "admin")    log.Fatal("严重错误") // 以代码 1 终止程序}

log 的关键功能：

log.Println() — 输出字符串
log.Printf() — 格式化输出
log.Fatal() — 输出并终止程序
log.Panic() — 输出并引发 panic

但标准日志记录器有缺点：没有级别 (debug, info, error)，没有结构化输出 (JSON)，没有文件轮转。

2. 添加日志级别

对于生产应用程序，按级别区分日志至关重要。以下是使用标准包的最小实现：

package main

import (    "log"    "os")

type Logger struct {    debug *log.Logger    info  *log.Logger    warn  *log.Logger    error *log.Logger}

func NewLogger() *Logger {    flags := log.Ldate | log.Ltime | log.Lshortfile    return &Logger{        debug: log.New(os.Stdout, "DEBUG: ", flags),        info:  log.New(os.Stdout, "INFO: ", flags),        warn:  log.New(os.Stderr, "WARN: ", flags),        error: log.New(os.Stderr, "ERROR: ", flags),    }}

func (l *Logger) Debug(msg string, args ...interface{}) {    l.debug.Printf(msg, args...)}

func (l *Logger) Info(msg string, args ...interface{}) {    l.info.Printf(msg, args...)}

func (l *Logger) Error(msg string, args ...interface{}) {    l.error.Printf(msg, args...)}

func main() {    log := NewLogger()    log.Info("服务器已在端口 %d 上启动", 8080)    log.Debug("来自 %s 的请求", "192.168.1.1")    log.Error("无法连接到数据库：%v", "timeout")}

建议： 在生产环境中，使用 os.Stderr 处理错误，使用 os.Stdout 处理常规日志——这简化了通过 systemd 或 Docker 收集日志的过程。