Go测试中全局变量是测试污染的头号来源，根本解法是从设计上切断全局状态渗透：用TestMain做包级重置、t.Setenv()覆盖临时状态、依赖注入移除全局变量、GoConvey的Reset()作用域隔离。
Go测试中全局变量是测试污染的头号来源——一个测试改了 globalConfig，下一个测试就可能因读到脏数据而失败，尤其在 t.Parallel() 下极易触发数据竞争。根本解法不是“小心别改”，而是从设计上切断全局状态对测试的渗透。
用 TestMain 做包级环境重置
这是最粗粒度但最稳妥的隔离手段，适用于所有测试共用同一套初始化逻辑的场景（如数据库连接、配置加载）。它确保每个 go test 进程只初始化/清理一次，避免测试间状态残留。
- 必须调用
m.Run()，否则测试不会执行 -
teardown()里要显式释放资源（如db.Close()），不能只清空指针 - 不适用于需要为每个测试单独定制环境的场景（比如不同测试要不同
API_ENDPOINT）
func TestMain(m *testing.M) {
setup()
code := m.Run()
teardown()
os.Exit(code)
}
func setup() {
globalDB = mustConnectTestDB()
globalConfig = &Config{Env: "test"}
}
func teardown() {
if globalDB != nil {
globalDB.Close()
}
globalDB = nil
globalConfig = nil
}
用 t.Setenv() 和闭包覆盖临时状态
当测试只依赖环境变量或可变全局配置（如 log.Level、http.DefaultClient）时，t.Setenv() 是轻量且线程安全的选择；对不可 Setenv 的变量，则用 defer 恢复原值。
-
t.Setenv()只影响当前测试及其子测试，自动恢复，无需手动清理 - 对非字符串型全局变量（如结构体指针），必须用闭包保存旧值 +
defer恢复，否则并发下会错乱 - 避免在
t.Parallel()子测试里直接赋值全局变量，即使加了sync.Mutex，也难保测试框架自身调度顺序
func TestHTTPClientWithTimeout(t *testing.T) {
oldClient := http.DefaultClient
http.DefaultClient = &http.Client{Timeout: 100 * time.Millisecond}
defer func() { http.DefaultClient = oldClient }()
// 测试逻辑...
}
用依赖注入彻底移除全局变量依赖
这是 Uber Go 规范推荐的终极方案——把全局变量变成函数参数或结构体字段。测试时传入 mock 或定制实例，运行时才注入真实依赖。从此测试不再“求”全局状态，而是“控”输入边界。
- 接口定义要窄：比如只暴露
ConfigProvider.GetTimeout()，而非整个*Config结构体 - 构造函数优先接收依赖，而非在内部读取全局变量（如
NewService(cfg ConfigProvider)而非NewService()） - 对时间、随机数等隐式全局依赖，也应抽象为接口（
Clock.Now()、Rand.Intn()），方便冻结测试时间点
type Service struct {
cfg ConfigProvider
db *sql.DB
}
func NewService(cfg ConfigProvider, db sql.DB) Service {
return &Service{cfg: cfg, db: db}
}
func TestService_Process(t testing.T) {
mockCfg := &mockConfig{timeout: 5 time.Second}
s := NewService(mockCfg, testDB())
// ...
}
用 Reset() 配合 GoConvey 作用域隔离
如果你已在用 GoConvey，它的 Reset() 是专为测试状态清理设计的钩子——在每个 Convey 块退出时自动执行，比手写 defer 更可靠，尤其适合嵌套测试场景。
-
Reset()在作用域结束时触发，包括测试 panic 或提前 return 的情况 - 不要在
Reset()里做耗时操作（如 DB rollback），它会拖慢整个测试套件 - 与
TestMain不冲突：前者管单个测试块，后者管整个包生命周期
Convey("When processing user request", t, func() {
userRepo = newMockUserRepo()
So(userRepo.Count(), ShouldEqual, 0)
Reset(func() {
userRepo = nil // 确保下一个 Convey 从干净状态开始
})
Convey("should create user", func() {
CreateUser("alice")
So(userRepo.Count(), ShouldEqual, 1)
})
})
真正难的不是写隔离代码，而是识别哪些变量本就不该是全局的——比如缓存、客户端、配置、时间。一旦它们出现在多个测试里被反复修改，说明设计已泄漏状态。这时候重构比加锁、加 Reset 更治本。