Ubuntu系统下如何配置Golang日志系统详细步骤完整教程

在 Ubuntu 环境下为 Golang 项目构建日志系统，其实有很多方案可供选择。最直接的方式是使用标准库 log 包，轻量且零依赖；如果项目对日志级别、结构化输出有更高要求，那么 logrus、zap 这类第三方库会更加顺手。下面先从标准库说起。

标准库 log 的配置主要分三步：

• 设置日志输出：默认是控制台，但你可以同时写入文件，或者用 io.MultiWriter 组合多个目标。

• 自定义日志格式：时间戳、文件名、行号这些都可以控制，通过 SetFlags 调整即可。

• 模拟日志级别：标准库本身没有级别概念，但可以借助前缀变通实现——比如用不同前缀区分 INFO、ERROR。

下面是一个实际例子，这段代码将日志同时输出到控制台和 app.log 文件，并设置了日期、时间和调用位置信息：

package main

import (
    "io"
    "log"
    "os"
)

func main() {
    // 创建日志文件
    logFile, err := os.OpenFile("app.log", os.O_CREATE|os.O_WRONLY|os.O_APPEND, 0666)
    if err != nil {
        log.Fatalf("error opening log file: %v", err)
    }
    defer logFile.Close()

    // 同时输出到文件和控制台
    log.SetOutput(io.MultiWriter(logFile, os.Stdout))

    // 设置前缀和标志
    log.SetPrefix("INFO: ")
    log.SetFlags(log.Ldate | log.Ltime | log.Lshortfile)

    // 写入日志
    log.Println("This is an informational message.")
    log.Printf("This is a formatted %s message.", "info")

    // 切换前缀表示错误级别
    log.SetPrefix("ERROR: ")
    log.Println("This is an error message.")
}

可以看到，通过切换前缀就能简单区分不同严重程度的日志。虽然不如原生级别库方便，但胜在无需引入额外依赖。

当然，标准库只能做到这个程度。如果项目需要真正的日志级别、结构化输出（比如 JSON 格式）、字段绑定等能力，那么第三方库是更好的选择。logrus 就是其中非常成熟的一个。下面是用它记录带字段的结构化日志的典型用法：

package main

import (
    "os"
    "github.com/sirupsen/logrus"
)

func main() {
    logger := logrus.New()
    logger.SetOutput(os.Stdout)
    logger.SetFormatter(&logrus.JSONFormatter{})
    logger.SetLevel(logrus.InfoLevel)

    logger.Info("This is an informational message.")
    logger.WithFields(logrus.Fields{
        "animal": "walrus",
        "size":   10,
    }).Info("A group of walrus emerges from the ocean")

    logger.WithFields(logrus.Fields{
        "omg":    true,
        "number": 100,
    }).Error("The ice breaks!")
}

使用前记得用 go get 安装：

go get github.com/sirupsen/logrus

安装完成后，结合官方文档的说明就能快速上手了——logrus 的字段绑定、Hook 机制、多输出格式都很成熟，适合中大型项目。如果追求极致性能，也可以考虑 zap，它在高并发场景下表现更优。总之，根据项目实际需求选择最适合的那一个就好。