-go test -p 控制不同测试包间的并发数,默认为4,与t.parallel()无关;单包内提速需合理使用t.parallel(),前提是测试间无状态共享、隔离良好,且避免flag.parse、log.setoutput等全局副作用。

Go test -p 参数控制并行度,别信默认值
Go 的 go test 默认会限制并发运行的测试包数量(不是测试函数),由 -p 控制,默认是 -p 4。但很多人误以为它控制的是单个测试文件里 t.Parallel() 的并发数——其实完全无关。-p 只影响「不同测试包」之间的并行执行,比如你有 pkgA/ 和 pkgB/ 两个包,-p 2 表示最多同时跑这两个包的测试进程。
- 如果你的项目是单包结构(绝大多数小项目),
-p调再大也没用,所有测试仍在同一个进程中串行跑(除非你手动调t.Parallel()) - 真正提升单包内测试速度的关键是合理使用
t.Parallel(),但它要求测试函数之间无共享状态、不读写同一全局变量、不操作同一临时文件或端口 - 常见错误:在
TestXxx里直接改os.Setenv或复位http.DefaultClient,然后加t.Parallel()—— 测试会随机失败,因为环境被其他并行测试污染
什么时候该用 t.Parallel(),什么时候必须禁用
t.Parallel() 不是性能银弹,它只在「I/O 等待明显、CPU 占用低、彼此隔离」的测试中才安全有效。典型适用场景包括 HTTP client 请求 mock、数据库查询(用 sqlmock)、S3 客户端调用等。
- ✅ 安全用法:每个测试起独立 http.Server 监听随机端口,或用
httptest.NewServer;数据库连接用sqlmock.New创建新实例 - ❌ 危险用法:共用一个全局
sync.Map缓存、复用同一个<em>sql.DB</em>连接池(没做事务隔离)、调用time.Sleep(100 time.Millisecond)后断言时间戳 - 特别注意:如果测试里用了
flag.Parse()或修改了log.SetOutput,这些副作用会跨测试泄漏,加t.Parallel()后行为不可预测 - 一个简单判断法:把测试函数复制两份,分别重命名后不加
t.Parallel()运行,看是否都通过;如果通过,再尝试加t.Parallel()并反复跑 10 次(go test -count=10),观察是否稳定
GOFLAGS 和环境变量干扰测试稳定性
Go 1.21+ 默认开启 GOFLAGS="-mod=readonly",这会让某些依赖 go:generate 或动态生成代码的测试在 CI 中失败,因为 go test 内部可能触发模块下载或写文件。
- 本地开发时,
GOFLAGS常被 IDE 或 shell profile 注入(比如-gcflags="all=-N -l"),导致测试二进制体积暴增、启动变慢,甚至触发编译器 bug - 更隐蔽的问题:某些测试依赖
os.Getenv("HOME")或user.Current(),而 CI 环境的HOME是空或只读路径,测试创建临时目录失败却没报错,只是静默跳过 - 推荐做法:在
go.testFlags(VS Code)或 Makefile 里显式清空关键变量:GOFLAGS= go test -v ./...;对敏感环境变量,用t.Setenv("HOME", t.TempDir())隔离 - 不要依赖
os.Clearenv()全局清理——它会影响os/exec.Command查找系统命令的PATH,导致子进程启动失败
测试覆盖与性能其实是反向权衡的关系
go test -cover 本身会显著拖慢测试速度(尤其大项目),因为它需要插桩计数每行执行次数。而很多人为了“提高覆盖率”强行拆分逻辑、增加空分支或 mock 所有 error path,反而让测试更脆弱、更难维护。
立即学习“go语言免费学习笔记(深入)”;
-
-covermode=count比atomic慢 3–5 倍,且生成的cover.out文件巨大;日常开发用-covermode=atomic足够 - 覆盖率数字没有意义:100% 覆盖不等于没 bug,70% 也可能已捕获所有关键路径。重点应放在「边界输入、error 返回、context cancel」三类 case 是否被测到
- 真正影响性能的往往是测试初始化:比如每个 Test 函数都重新加载 YAML 配置、新建 gRPC 连接、启动嵌入式 Etcd 实例。应该用
TestMain提前准备,或用sync.Once+ 包级变量缓存(但要注意并发安全)
并行测试不是开个开关就完事的事。最常被忽略的,是测试之间那些看不见的状态耦合——它们不会报错,只会让测试偶尔失败、难以复现、最终被加 // TODO: flaky 注释掉。











