TestMain 是 Go 中用于控制测试流程的函数，通过接收 *testing.M 参数实现测试前后的 setup 与 teardown 操作。在 TestMain 中调用 m.Run() 执行所有测试，并手动调用 os.Exit(exitCode) 返回结果。它适用于全局初始化、资源清理等场景，但需注意每个包仅能定义一个 TestMain，且不可省略 m.Run() 和 os.Exit() 调用。
在Go语言中，testing.M 是 testing 包提供的一个结构体，用于控制测试的整个执行流程。它允许你在所有测试运行前后执行自定义逻辑，比如初始化配置、连接数据库、清理资源等。通过实现 TestMain 函数，你可以接管测试的入口点。
什么是 TestMain 和 testing.M
默认情况下，Go 测试会自动运行所有以 Test 开头的函数。但当你需要在测试开始前或结束后执行某些操作时，就需要使用 TestMain(m *testing.M)。这个函数必须存在于包级别，并且参数类型为 *testing.M。
testing.M 提供了对测试生命周期的控制能力：
- m.Run()：显式运行所有测试用例，返回退出码
- 你可以在这之前做 setup，在之后做 teardown
如何编写 TestMain 函数
下面是一个典型示例，展示如何使用 TestMain 来管理测试流程：
立即学习“go语言免费学习笔记（深入）”；
package main
import (
"log"
"os"
"testing"
)
func TestMain(m *testing.M) {
// 测试前的准备工作
log.Println("✅ 开始设置测试环境...")
// 示例：创建临时文件、初始化数据库连接等
// db = connectToTestDB()
// configFile = createTempConfig()
// 运行所有测试
exitCode := m.Run()
// 测试后的清理工作
log.Println("? 清理测试环境...")
// 示例：关闭数据库、删除临时文件
// db.Close()
// os.Remove(configFile)
// 使用系统退出码退出
os.Exit(exitCode)
}
在这个例子中：
- 调用
m.Run()会触发所有TestXxx函数的执行 - 返回值
exitCode表示测试结果（0 表示成功，非0表示失败） - 必须手动调用
os.Exit()并传入该码，否则测试不会正确结束
常见应用场景
使用 testing.M 特别适合以下情况：
- 全局初始化：加载配置文件、建立数据库连接池
- 资源预分配：启动 mock 服务、准备测试数据目录
- 性能基准前的准备：预热缓存、加载模型
- 统一日志或监控：记录测试开始/结束时间
注意：如果不需要特殊控制，不必使用 TestMain，避免增加复杂度。
注意事项与最佳实践
使用 testing.M 时需小心以下几个问题：
- 每个包只能有一个
TestMain函数 - 记得调用
m.Run()，否则测试不会执行 - 务必调用
os.Exit()传递返回码，不能省略 - 避免在
TestMain中调用其他测试函数，由框架自动调度 - 并行测试（t.Parallel）仍可正常工作，但 setup 阶段是串行的
基本上就这些。合理使用 testing.M 能让你更好地掌控测试环境生命周期，让测试更稳定可靠。
