Go 中全局 init() 函数会在包导入时自动运行，无法跳过或延迟；若测试需预设环境变量，应使用 TestMain 统一管理测试前后的环境准备与清理，避免 init() 在测试初始化前误读空/旧环境值。
go 中全局 `init()` 函数会在包导入时自动运行，无法跳过或延迟；若测试需预设环境变量，应使用 `testmain` 统一管理测试前后的环境准备与清理，避免 `init()` 在测试初始化前误读空/旧环境值。
在 Go 应用中，常将配置加载逻辑（如解析环境变量）放在 init() 函数中，以确保程序启动时配置已就绪。但这种设计会给单元测试带来挑战：Go 的 init() 函数在包被导入时即执行，早于 testing 包的测试生命周期——这意味着，当你在测试文件中通过 func init() 设置 os.Setenv() 时，主包的 init() 已经执行完毕，此时再设置环境变量已无意义，导致 env.Parse(&envConfig) 读取到空值或默认值，测试失败。
正确解法是使用 TestMain —— 它是 Go 测试框架提供的入口钩子函数，允许你在所有测试运行前执行自定义初始化，并在全部测试结束后执行清理，从而精准控制 init() 所依赖的环境状态。
✅ 正确示例（config_test.go）：
package main
import (
"os"
"testing"
)
func TestMain(m *testing.M) {
// 【关键】在主包 init() 执行前，预先设置环境变量
os.Setenv("APP_HOST", "http://localhost:9999")
os.Setenv("APP_USERNAME", "john")
os.Setenv("APP_PASSWORD", "doe")
// 此时 main 包的 init() 将读取刚设置的变量
exitCode := m.Run()
// 【可选】测试后清理，避免污染其他测试（尤其并行测试时）
os.Unsetenv("APP_HOST")
os.Unsetenv("APP_USERNAME")
os.Unsetenv("APP_PASSWORD")
os.Exit(exitCode)
}
func TestEnvConfig(t *testing.T) {
// 此时 envConfig 已由 init() 正确填充
if envConfig.Host == "" {
t.Fatal("envConfig.Host is empty — init() may have run before env vars were set")
}
if envConfig.Host != "http://localhost:9999" {
t.Errorf("expected Host %q, got %q", "http://localhost:9999", envConfig.Host)
}
}
⚠️ 注意事项：
- TestMain 必须定义在包含测试函数的包中，且函数签名严格为 func TestMain(*testing.M)；
- m.Run() 必须被调用，否则所有测试将被跳过；
- 若项目使用 go test -race 或并行测试（t.Parallel()），务必在 TestMain 中完成所有环境设置，不可依赖多个 init() 函数的执行顺序；
- 避免在 TestMain 中执行耗时操作（如网络请求、文件 I/O），否则会拖慢整个测试套件；
- 更健壮的做法是：将配置加载逻辑从 init() 移至显式初始化函数（如 LoadConfig()），使测试能按需调用，彻底解耦初始化时机——这是更易测、更符合 Go 显式优于隐式原则的设计。
总结：init() 是“隐式启动器”，而 TestMain 是测试场景下的“显式控制点”。善用 TestMain，即可在保障生产代码简洁性的同时，实现可靠、可重复、可维护的配置测试。
