ubuntu下golang日志级别设置

在 Ubuntu 下使用 Golang 进行开发时，日志级别的设置通常依赖于你使用的日志库。以下是一些常用的日志库及其配置方法：

1. 使用标准库 log

Go 语言自带的标准库 log 功能比较基础，它本身并不直接支持我们常说的日志级别（如 Debug、Info、Error）。不过，这并不意味着你无法实现类似的效果。通过自定义日志输出的前缀和格式，再结合手动判断，完全可以搭建一个简单的分级日志框架。

package main

import (
    "log"
    "os"
)

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

    log.Println("这是一条信息日志")
    log.Println("这是一条警告日志") // 仍然输出为 INFO 级别
}

简单来说：

• 标准库的 log 包胜在简单直接，对于小型工具或脚本来说完全够用。
• 但如果项目规模稍大，需要精细地控制不同级别日志的输出与过滤，那么转向功能更全的第三方库会是更明智的选择。

2. 使用第三方日志库 logrus

当标准库无法满足需求时，logrus 往往是许多开发者的首选。它功能强大，社区活跃，最关键的是，对日志级别的支持非常完善。

安装起来很简单：

go get github.com/sirupsen/logrus

来看一个具体的例子：

package main

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

func main() {
    // 创建一个新的 Logger 实例
    logger := logrus.New()

    // 设置日志级别为 Debug（最低级别）
    logger.SetLevel(logrus.DebugLevel)
    // 设置日志格式为文本格式
    logger.SetFormatter(&logrus.TextFormatter{
        FullTimestamp: true,
    })

    logger.Debug("这是一条 Debug 日志")
    logger.Info("这是一条 Info 日志")
    logger.Warn("这是一条 Warn 日志")
    logger.Error("这是一条 Error 日志")

    // 设置日志级别为 Warn，只有 Warn 及以上级别的日志会输出
    logger.SetLevel(logrus.WarnLevel)
    logger.Debug("这条 Debug 日志不会输出")
    logger.Warn("这条 Warn 日志会输出")
}

这里有几个要点：

• logrus 预定义了从 Debug、Info、Warn 到 Error、Fatal、Panic 等多个级别，覆盖了绝大多数场景。
• 通过 SetLevel 方法，你可以像拧水龙头一样，轻松控制当前输出哪些级别的日志。这在开发调试和线上运行时切换日志详细程度时特别有用。

3. 使用第三方日志库 zap

如果你的应用对性能极其敏感，比如高频交易系统或核心API网关，那么 zap 这个由 Uber 开源的日志库就值得深入了解一下。它以极低的性能开销著称。

安装命令如下：

go get -u go.uber.org/zap

它的配置稍显复杂，但换来的是极致的性能：

package main

import (
    "go.uber.org/zap"
    "go.uber.org/zap/zapcore"
    "os"
)

func main() {
    // 定义日志级别
    level := zap.NewAtomicLevelAt(zap.InfoLevel)

    // 配置编码器
    encoderConfig := zapcore.EncoderConfig{
        TimeKey:       "time",
        LevelKey:     "level",
        NameKey:      "logger",
        CallerKey:    "caller",
        MessageKey:   "msg",
        StacktraceKey: "stacktrace",
        LineEnding:   zapcore.DefaultLineEnding,
        EncodeLevel:  zapcore.CapitalColorLevelEncoder,
        EncodeTime:   zapcore.ISO8601TimeEncoder,
        EncodeDuration: zapcore.SecondsDurationEncoder,
    }

    // 创建核心
    core := zapcore.NewCore(
        zapcore.NewJSONEncoder(encoderConfig),
        zapcore.AddSync(os.Stdout),
        level,
    )

    // 创建 Logger
    logger := zap.New(core, zap.AddCaller())
    defer logger.Sync()

    logger.Debug("这是一条 Debug 日志") // 不会输出
    logger.Info("这是一条 Info 日志")
    logger.Warn("这是一条 Warn 日志")
    logger.Error("这是一条 Error 日志")
}

简单总结一下：

• zap 的核心优势在于高性能和结构化日志输出，非常适合生产环境。
• 同样，通过 SetLevel 方法可以灵活控制日志级别，确保在需要时输出关键信息，在追求性能时过滤掉冗余内容。

4. 配置文件管理日志级别

对于稍具规模的应用，将日志级别硬编码在代码里可不是个好主意。更好的做法是将其抽取到外部配置文件中，比如 JSON、YAML 或 TOML。这样一来，调整日志级别就无需重新编译和部署应用了。

举个例子，我们使用 JSON 配置文件：

config.json:

{
    "log_level": "info"
}

然后在 Go 代码中读取并应用这个配置：

package main

import (
    "encoding/json"
    "io/ioutil"
    "log"
    "os"
    "github.com/sirupsen/logrus"
)

type Config struct {
    LogLevel string `json:"log_level"`
}

func main() {
    // 读取配置文件
    configFile, err := os.Open("config.json")
    if err != nil {
        log.Fatalf("无法打开配置文件: %v", err)
    }
    defer configFile.Close()

    byteValue, _ := ioutil.ReadAll(configFile)
    var config Config
    json.Unmarshal(byteValue, &config)

    // 设置日志级别
    level, err := logrus.ParseLevel(config.LogLevel)
    if err != nil {
        log.Fatalf("无效的日志级别: %v", err)
    }
    logrus.SetLevel(level)

    logrus.Info("应用启动成功")
}

这种做法的好处显而易见：

• 实现了配置与代码的分离，提升了应用的灵活性和可维护性。
• 你可以根据环境（开发、测试、生产）轻松切换不同的配置文件，动态调整日志的详细程度。

总结

在 Ubuntu 环境下进行 Golang 开发，选择合适的日志管理策略是构建可维护应用的重要一环。简单需求交给标准库 log 足矣；当需要丰富的级别和功能时，logrus 提供了绝佳的平衡；而对性能有严苛要求的场景，zap 则是强有力的武器。无论选择哪个，结合外部配置文件来管理日志级别，都能让你的应用更加灵活和健壮。说到底，清晰的日志是快速定位问题的基石，值得花点心思把它配置好。