Golang日志记录技巧与输出方法

在Go语言开发中，日志是问题排查与系统监控的核心工具，本文深入浅出地展示了如何仅依赖标准库log包，辅以少量封装和轻量级第三方库（如lumberjack），构建一套简洁、可靠、可维护的日志记录方案：从基础控制台输出、添加时间戳与文件定位信息，到将日志持久化至文件、实现DEBUG/INFO/WARN/ERROR分级控制，再到自动轮转切割与压缩归档，全面覆盖中小型项目对日志可读性、可追溯性及磁盘安全性的核心需求——无需引入复杂框架，也能写出专业级日志实践。

在Go语言开发中，日志是排查问题、监控系统运行状态的重要工具。一个简单的日志收集方案不需要依赖复杂的框架，通过标准库就能实现基本的记录与输出功能。

使用标准库 log 实现基础日志输出

Go 的 log 包提供了最基本的日志功能，可以将信息输出到控制台或文件。

package main

import (
    "log"
)

func main() {
    log.Println("这是一条普通日志")
    log.Printf("用户 %s 登录失败", "alice")
}

默认会输出时间、文件名和行号（需设置标志位）：

log.SetFlags(log.LstdFlags | log.Lshortfile)

这样每条日志会包含时间戳和调用位置，便于追踪。

将日志写入文件

为了长期保存日志，需要将内容写入文件而不是仅打印到终端。

file, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
if err != nil {
    log.Fatal("无法打开日志文件:", err)
}
defer file.Close()

log.SetOutput(file)
log.Println("这条日志会被写入文件")

通过 SetOutput 可以将日志目标从默认的 stderr 改为任意 io.Writer，包括文件、网络连接等。

实现简单的日志分级

实际项目中通常需要区分日志级别，如 debug、info、warn、error。虽然标准库不直接支持分级，但可以简单封装实现。

type LogLevel int

const (
    DEBUG LogLevel = iota
    INFO
    WARN
    ERROR
)

func Log(level LogLevel, msg string) {
    prefix := map[LogLevel]string{
        DEBUG: "DEBUG",
        INFO:  "INFO ",
        WARN:  "WARN ",
        ERROR: "ERROR",
    }[level]
    log.Printf("[%s] %s", prefix, msg)
}

// 使用示例
Log(DEBUG, "开始处理请求")
Log(ERROR, "数据库连接失败")

也可以扩展为结构体 logger，支持不同级别对应不同输出目标，比如 error 写入独立文件。

结合轮转避免日志过大

长时间运行的服务会产生大量日志，建议结合日志轮转机制。可使用第三方库如 lumberjack 实现自动切割。

先安装：

go get gopkg.in/natefinch/lumberjack.v2

配置输出：

import "gopkg.in/natefinch/lumberjack.v2"

log.SetOutput(&lumberjack.Logger{
    Filename:   "logs/app.log",
    MaxSize:    10,    // 每个文件最大 10MB
    MaxBackups: 3,     // 最多保留 3 个备份
    MaxAge:     7,     // 文件最多保存 7 天
    Compress:   true,  // 启用压缩
})

这样能有效防止磁盘被日志占满。

基本上就这些。用好标准库加简单封装，就能满足大多数中小型项目的日志需求，不复杂但容易忽略细节。

本篇关于《Golang日志记录技巧与输出方法》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！