Go test -count=1 什么时候适合关闭测试缓存

如果你执行的是 go test ./...，看到输出里的 (cached)，说明 Go 可能直接复用了上一次成功的测试结果。此时想确认测试代码、模块内文件或测试依赖的环境是否在本次真正执行，最直接的写法是 go test -count=1 ./...。但如果命令只是当前目录下的 go test，它属于 local directory mode，本来就不使用测试结果缓存，额外加上 -count=1 通常没有必要。

先区分两种 go test 模式：目录测试与包列表测试

判断要不要加参数，第一步不是清缓存，而是看命令有没有显式的包列表。直接在某个包目录运行 go test，属于当前目录模式；官方文档明确说明，这种模式不启用测试结果缓存。相反，go test ./...、go test ./internal/... 会先展开包列表，属于 package list mode，成功测试结果可能被保存并复用。

复用缓存时，Go 会把上次输出重新展示，并在摘要行用 (cached) 替代耗时。它不是失败，也不表示测试被跳过了错误处理；它只表示这次运行满足缓存匹配条件。匹配会考虑测试二进制，以及一组允许缓存的测试参数。测试读取的模块内文件或环境变量没有变化时，也可能继续匹配。

用 -count=1 强制本次测试重新执行

-count 控制每个测试、benchmark 和 fuzz seed 的运行次数；写成 -count=1 时，Go 将它作为明确关闭测试结果缓存的惯用方式。最常用的场景是包列表命令：

# 强制所有匹配包重新运行一次测试
go test -count=1 ./...

# 只重新运行一个测试，并保留详细输出
go test -count=1 -run '^TestConfigReload$' -v ./internal/config

它适合用在测试依赖当前环境的复查，例如刚改过模块内的测试数据文件、切换了影响测试的环境变量，或者怀疑上次成功结果掩盖了时间、随机数、临时目录和外部服务状态的问题。这里的重点是“强制这次测试二进制实际运行”，而不是把不稳定测试变成稳定测试；如果测试本身依赖不可控的外部状态，仍然应该修正测试隔离。

有一个容易忽略的边界：-count=1 不会把编译好的包全部删掉，也不会清空模块下载缓存。Go 仍然可以复用构建产物，只是不会直接拿成功的测试结果代替本次测试执行。因此它比全局清缓存更适合日常排查。

用 GODEBUG 看清缓存为什么被复用

如果你想知道“为什么这条命令显示 cached”，不要先反复删除缓存。可以临时开启 gocachetest 调试信息：

# 只为本次命令打印测试缓存判断细节
GODEBUG=gocachetest=1 go test ./...

# Windows PowerShell 可用临时环境变量方式
$env:GODEBUG = 'gocachetest=1'
go test ./...

输出可能比较长，但它能帮助你区分：测试二进制是否相同、命令参数是否仍在可缓存范围、模块内文件或环境变量输入是否发生变化。排查完成后关闭这个临时变量即可，不需要把它写进全局配置。

也不要把“加一个非缓存参数”当作比 -count=1 更好的技巧。官方确实说明，使用缓存允许列表之外的测试或非测试参数也会阻止结果缓存，但这种写法可能改变测试语义。要表达“我要重新跑一次”，就使用语义清楚的 -count=1。

不要把 -count=1 当成清理所有缓存

三类缓存动作要分开：

• -count=1：只影响本次命令是否复用成功的测试结果。
• go clean -testcache：让 Go 的测试结果缓存失效，但不删除构建缓存。
• go clean -cache：删除整个 Go 构建缓存，通常只在专门排查构建产物问题时使用。

如果问题是“测试没有重新执行”，优先选择 -count=1；如果要让之后的测试都不再使用旧的测试结果，再考虑 go clean -testcache。如果怀疑编译器、构建参数或 cgo 相关产物，才把调查范围扩大到构建缓存。扩大清理范围会增加后续编译时间，不能替代对测试输入和隔离性的检查。

常见问题

当前目录运行 go test，还需要加 -count=1 吗？

通常不需要。当前目录模式不启用测试结果缓存；如果团队脚本为了统一命令保留这个参数，也不会把它当成清理构建缓存的操作。

-count=1 会不会让 benchmark 只运行一次？

会影响 benchmark 的计数语义，因为 -count 也控制 benchmark 的重复次数；它不是“只跑一个测试函数”的开关。benchmark 的单次采样次数仍由 -benchtime 等参数控制。

为什么加了 -count=1，测试还是看起来很快？

它只绕过测试结果缓存，构建缓存仍可能复用；此外测试本身也可能很短。可以加 -v 查看测试输出，或用 GODEBUG=gocachetest=1 辅助判断，不要仅凭耗时猜测。

想让所有测试结果失效，应该用什么？

使用 go clean -testcache。它和 -count=1 的区别是前者改变后续测试结果缓存状态，后者只表达当前这次命令不要复用结果。