Go 中如何在包级作用域安全初始化条件型全局变量

在 go 库包中，可通过 init() 函数一次性解析环境变量并初始化全局布尔变量，避免每次调用函数时重复读取与转换，兼顾性能与简洁性。

在 Go 语言中，包级变量的初始化表达式必须是编译期可求值的常量表达式，因此像 strconv.ParseBool(os.Getenv("MYVAR")) 这类运行时依赖的操作无法直接用于变量声明（会导致编译错误）。但 Go 提供了 init() 函数这一特殊机制——它在包初始化阶段自动执行，且保证在任何包级变量使用前完成，是处理此类“运行时全局配置”的标准方案。

以下是一个生产就绪的实现示例：

package mylib

import (
    "fmt"
    "os"
    "strconv"
    "log"
)

// 声明包级变量（零值安全）
var (
    myvar     string
    myvarbool bool
    myvarSet  bool // 标记是否已成功解析，便于诊断
)

func init() {
    myvar = os.Getenv("MYVAR")
    if myvar == "" {
        // 可选：设默认值或记录警告
        log.Printf("Warning: environment variable MYVAR not set, using false")
        myvarbool = false
        myvarSet = true
        return
  
  }

    var err error
    myvarbool, err = strconv.ParseBool(myvar)
    if err != nil {
        log.Printf("Warning: invalid value for MYVAR=%q, defaulting to false: %v", myvar, err)
        myvarbool = false
    }
    myvarSet = true
}

// 工具函数：无需重复解析，直接使用预计算结果
func MyCheck() {
    if myvarbool {
        fmt.Print("MYVAR is true")
    } else {
        fmt.Print("MYVAR is false or unset")
    }
}

✅ 关键要点说明：

• init() 在 main() 执行前、且仅执行一次，天然适配库包无 main 的场景；
• 显式处理空值和解析错误，避免静默失败（如 strconv.ParseBool("") panic）；
• 使用 log.Printf 而非 fmt.Printf，确保调试信息在测试/部署中可被统一捕获；
• 引入 myvarSet 标志位（可选）便于后续扩展健康检查或配置验证逻辑。

⚠️ 注意事项：

• 避免在 init() 中执行阻塞操作（如网络请求、文件 I/O），否则会拖慢整个程序启动；
• 环境变量读取具有进程启动时刻快照语义——后续修改环境变量对已运行程序无效；
• 若需热重载配置，应改用显式初始化函数（如 SetupConfig()）+ 同步机制，而非依赖 init()。

通过 init() 初始化全局条件变量，既符合 Go 的初始化模型，又实现了配置即代码（Configuration-as-Code）的轻量实践，是构建可维护 Go 库的推荐模式。