Debian Golang日志级别设置指南

在Debian系统上为Golang应用程序设置日志级别，主要通过选择日志库（标准库或第三方库）并配置日志级别参数实现。以下是具体步骤及常见库的配置示例：

一、准备工作

1. 安装Go环境：确保Debian系统已安装Go（可通过go version验证），未安装则参考官方文档下载安装。
2. 初始化Go模块（可选）：若使用第三方库，建议通过go mod init <项目名>初始化模块，便于依赖管理。

二、使用Go标准库log包（基础实现）

Go标准库的log包无内置日志级别功能，需通过自定义函数+全局变量模拟：

package main

import (
	"log"
	"os"
)

// 定义日志级别常量（数值越小，级别越高）
const (
	DEBUG = iota // 0
	INFO         // 1
	WARNING      // 2
	ERROR        // 3
	FATAL        // 4
)

// 全局日志级别（默认INFO）
var LogLevel = INFO

// 自定义日志函数（根据级别过滤）
func logDebug(msg string) { if LogLevel <= DEBUG { log.Printf("[DEBUG] %s", msg) } }
func logInfo(msg string)  { if LogLevel <= INFO  { log.Printf("[INFO]  %s", msg) } }
func logWarning(msg string) { if LogLevel <= WARNING { log.Printf("[WARN]  %s", msg) } }
func logError(msg string)  { if LogLevel <= ERROR  { log.Printf("[ERROR] %s", msg) } }
func logFatal(msg string)  { if LogLevel <= FATAL  { log.Fatalf("[FATAL] %s", msg) } }

func main() {
	// 设置日志输出到标准输出（可选）
	log.SetOutput(os.Stdout)
	// 设置日志前缀（可选）
	log.SetPrefix("[APP] ")

	// 测试日志输出（仅INFO及以上级别会显示）
	logDebug("This is a debug message") // 不输出
	logInfo("This is an info message")  // 输出
	logWarning("This is a warning")     // 输出
	logError("This is an error")        // 输出
}

说明：此方法需手动维护日志级别逻辑，适合简单项目；复杂场景建议使用第三方库。

三、使用第三方日志库（推荐）

1. Logrus（功能丰富，社区常用）

Logrus支持Debug、Info、Warn、Error、Fatal、Panic等级别，可通过代码或环境变量设置：

package main

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

func main() {
	// 初始化logger
	logger := logrus.New()
	// 设置日志级别（DebugLevel会输出所有级别日志）
	logger.SetLevel(logrus.DebugLevel)
	// 设置日志输出格式（JSON格式更易解析）
	logger.SetFormatter(&logrus.JSONFormatter{})
	// 设置日志输出目标（标准输出/文件）
	logger.SetOutput(os.Stdout)

	// 测试日志输出
	logger.Debug("Debug message") // 输出
	logger.Info("Info message")   // 输出
	logger.Warn("Warn message")   // 输出
	logger.Error("Error message") // 输出
}

环境变量控制（灵活调整级别，无需改代码）：

func main() {
	logger := logrus.New()
	// 从环境变量读取日志级别（默认INFO）
	logLevel := os.Getenv("LOG_LEVEL")
	if logLevel == "" {
		logLevel = "info"
	}
	level, err := logrus.ParseLevel(logLevel)
	if err != nil {
		logger.Fatalf("Invalid log level: %v", err)
	}
	logger.SetLevel(level)

	logger.Info("Log level set via environment variable")
}

说明：通过LOG_LEVEL=debug go run main.go可动态切换为Debug级别。

2. Zap（高性能，Uber开源）

Zap是Go的高性能结构化日志库，适合生产环境，支持Debug、Info、Warn、Error、DPanic、Panic、Fatal等级别：

package main

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

func main() {
	// 配置Zap logger
	config := zap.NewProductionConfig()
	// 设置日志级别（DebugLevel）
	config.Level.SetLevel(zapcore.DebugLevel)
	// 构建logger（自动同步缓冲区）
	logger, err := config.Build()
	if err != nil {
		panic(err)
	}
	defer logger.Sync() // 确保日志写入

	// 测试日志输出
	logger.Debug("Debug message") // 输出
	logger.Info("Info message")   // 输出
	logger.Warn("Warn message")   // 输出
	logger.Error("Error message") // 输出
}

环境变量控制（结合zapcore解析）：

func main() {
	// 从环境变量读取日志级别
	logLevel := os.Getenv("LOG_LEVEL")
	var level zapcore.Level
	if logLevel == "" {
		level = zapcore.InfoLevel // 默认INFO
	} else {
		if err := level.UnmarshalText([]byte(logLevel)); err != nil {
			panic(err)
		}
	}

	// 配置Zap
	config := zap.Config{
		Level:       zap.NewAtomicLevelAt(level),
		Development: false,
		Encoding:    "json",
		OutputPaths: []string{"stdout"},
		ErrorOutputPaths: []string{"stderr"},
	}
	logger, err := config.Build()
	if err != nil {
		panic(err)
	}
	defer logger.Sync()

	logger.Info("Log level set via environment variable")
}

说明：Zap的性能优于Logrus，适合高并发场景；zapcore.Level支持更严格的级别控制。

四、进阶：通过配置文件管理日志级别

若需更灵活的管理（如多环境差异化配置），可使用JSON/YAML配置文件：

// config.json
{
  "log_level": "debug",
  "log_format": "json",
  "output": "stdout"
}

package main

import (
	"encoding/json"
	"io/ioutil"
	"os"

	"github.com/sirupsen/logrus"
)

type Config struct {
	LogLevel   string `json:"log_level"`
	LogFormat  string `json:"log_format"`
	Output     string `json:"output"`
}

func main() {
	// 读取配置文件
	configData, err := ioutil.ReadFile("config.json")
	if err != nil {
		panic(err)
	}
	var config Config
	if err := json.Unmarshal(configData, &config); err != nil {
		panic(err)
	}

	// 初始化logger
	logger := logrus.New()
	logger.SetOutput(os.Stdout)

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

	// 设置日志格式
	if config.LogFormat == "json" {
		logger.SetFormatter(&logrus.JSONFormatter{})
	} else {
		logger.SetFormatter(&logrus.TextFormatter{})
	}

	logger.Info("Logger configured via config file")
}

说明：配置文件适合大型项目，便于统一管理日志策略。

五、注意事项

1. 生产环境选择：优先使用zap（高性能）或logrus（功能丰富），避免使用标准库的简易实现。
2. 日志输出目标：建议将日志输出到文件（如/var/log/app.log）而非标准输出，便于后续收集和分析。
3. 日志轮转：结合logrotate工具实现日志文件的自动轮转，防止日志文件过大。
4. 敏感信息过滤：避免在日志中输出密码、密钥等敏感信息，可使用logrus的Hook或zap的Field过滤。

通过以上步骤，可在Debian系统上为Golang应用程序灵活设置日志级别，满足不同场景的需求。