Golang如何在main包外配置全局Logger？该实现是否合规？

你的实现分析：不算反模式，但有明显局限 #

你当前的实现是Go中简化全局日志配置的一种可行方案，但不属于长期可扩展的最佳实践，也算不上明确的反模式——它更适合小型快速原型项目，在中大型项目中会暴露不少弊端：

该方案的核心弊端 #

• 运行时配置完全僵化：init函数在程序启动时仅执行一次，之后无法动态调整日志级别、输出格式或切换Handler（比如从JSON转文本、根据环境切换输出目标）。如果后续需要根据环境变量（dev/prod）调整配置，或运行时修改日志级别，这种实现完全做不到。
• 测试友好度极低：所有单元测试都会共享这个全局默认Logger，无法单独为某个测试用例替换Logger（比如禁用日志输出、捕获日志内容做断言），容易导致测试输出混乱，也难以验证日志行为。
• 依赖关系隐式化：其他包只导入了标准库slog，但实际依赖pkg/logger的初始化逻辑，这种隐式依赖会让代码可读性下降——新接手的开发者可能不知道日志配置来自哪里，排查问题时容易困惑。
• 扩展性差：如果后续需要多实例Logger（比如不同业务模块用不同的日志前缀、级别），这种全局单例模式无法支持，只能推翻重构。

更成熟的替代方案 #

方案1：显式初始化的全局Logger（平衡易用性与灵活性）

放弃init隐式初始化，在pkg/logger中暴露显式配置函数和受控的全局实例：

// pkg/logger/logger.go
package logger

import (
    "log/slog"
    "os"
)

var (
    globalLogger *slog.Logger
    levelVar     *slog.LevelVar
)

// Init 由main程序显式调用，控制初始化时机和配置
func Init(env string) {
    levelVar = new(slog.LevelVar)
    // 根据环境动态设置日志级别
    if env == "prod" {
        levelVar.Set(slog.LevelInfo)
    } else {
        levelVar.Set(slog.LevelDebug)
    }

    handlerOpts := &slog.HandlerOptions{Level: levelVar}
    handler := slog.NewJSONHandler(os.Stderr, handlerOpts)
    globalLogger = slog.New(handler)
    slog.SetDefault(globalLogger)
}

// SetLevel 提供运行时修改日志级别的能力
func SetLevel(level slog.Level) {
    if levelVar != nil {
        levelVar.Set(level)
    }
}

// Get 返回全局Logger实例，支持自定义扩展
func Get() *slog.Logger {
    return globalLogger
}

在main.go中显式初始化：

// cmd/main.go
package main

import (
    "os"
    "pkg/logger"
    "log/slog"
)

func main() {
    env := os.Getenv("APP_ENV")
    logger.Init(env)

    slog.Info("log from default logger")
    logger.Get().Debug("debug log for dev")
}

这种方案的优势：

• 依赖关系清晰，初始化时机可控
• 支持运行时配置调整
• 测试时可以单独调用Init配置测试专用Logger，避免全局污染

方案2：依赖注入（极致解耦，适合中大型项目）

完全避免全局依赖，通过结构体字段或函数参数传递Logger实例：

// pkg/user/service.go
package user

import "log/slog"

type Service struct {
    logger *slog.Logger
    // 其他业务依赖...
}

func NewService(logger *slog.Logger) *Service {
    return &Service{logger: logger}
}

func (s *Service) GetUser(id int) {
    s.logger.Info("getting user", "user_id", id)
    // 业务逻辑...
}

在main.go中初始化并注入Logger：

// cmd/main.go
package main

import (
    "log/slog"
    "os"
    "pkg/user"
)

func main() {
    // 初始化Logger
    handler := slog.NewJSONHandler(os.Stderr, nil)
    logger := slog.New(handler)

    // 将Logger注入业务模块
    userSvc := user.NewService(logger)
    userSvc.GetUser(123)
}

这种方案的优势：

• 模块依赖完全解耦，可读性和可维护性拉满
• 测试时可以轻松传入Mock Logger，方便验证日志输出
• 天然支持多Logger实例，不同模块可使用不同配置的Logger

总结 #

• 你当前的实现适合小型项目或快速原型，简单直接，但扩展性和测试性不足
• 如果项目需要长期维护或扩展，推荐显式初始化的全局Logger方案，平衡易用性和灵活性
• 中大型项目追求极致解耦和可测试性时，依赖注入是最优选择

内容的提问来源于stack exchange，提问作者purplenet