Go test 缓存为什么让修改后结果不变

如果修改测试或被测代码后，go test ./... 仍然给出旧结果，先看输出末尾有没有 (cached)。这通常不是 Go 忽略了文件，而是命令处于 package list mode，成功的测试结果被复用。一次性验证可以用 go test -count=1 ./...，需要批量清理时再用 go clean -testcache。

官方地址：https://pkg.go.dev/cmd/go

一、从执行模式和 cached 标记判断现象

先不要直接删除整个 Go 缓存。把两种命令放在同一个目录对照，重点观察输出是否带 (cached)：

# 第一次运行 package list mode，成功结果可能进入测试缓存
go test ./...

# 第二次运行：如果出现 (cached)，说明复用了成功结果
go test ./...

# 仅当前这次强制执行测试二进制，不改动全局缓存
go test -count=1 ./...

不带包参数的 go test 是当前目录的 local directory mode，这种模式不会使用测试缓存；显式写出 . 后就切换成 package list mode。也就是说，下面两条命令看起来只差一个点，缓存语义却不同：

# 当前目录模式：用于快速确认工作目录里的测试
go test

# 包列表模式：成功结果可能显示为 (cached)
go test .

二、理解哪些输入会让缓存命中或失效

Go 缓存的对象不是“某个文件名”，而是一次可缓存的成功 package test result。首先要看测试二进制是否由相同的源码和构建输入产生，其次要看命令行参数是否仍在可缓存范围内。-run、-v、-timeout 等属于可缓存 test flags，但加入不在范围内的测试参数或普通参数，通常会让这次运行不再命中。

测试读取包内文件或环境变量时，Go 还会把这些输入纳入匹配条件。文件内容或相关环境变量改变，后续运行就不应复用原结果。相反，测试依赖当前时间、随机数、外部服务或包目录之外的隐式状态时，缓存规则不能替你修复测试的不确定性。

三、用 count=1 验证修改是否真正生效

-count=1 是排查“旧结果”最小的动作。它不会删除构建缓存、模块下载缓存，也不会改变其他开发者的环境，只让本次测试不使用已有结果。建议先运行带 -count=1 的命令，再根据实际输出判断代码修改是否生效：

# 强制本次所有包执行测试，保留其余缓存
go test -count=1 ./...

# 只复跑一个包，缩小排查范围
go test -count=1 ./internal/order

# 需要更细日志时再打开 verbose，不要把日志误当成缓存清理
go test -count=1 -v ./internal/order

如果强制重跑后仍然得到同样结果，问题就不再是“缓存没清掉”。这时应检查测试是否读了错误的配置文件、命令是否在另一个模块目录执行、生成代码是否没有重新生成，或测试本身是否把外部状态固定成了旧值。

四、按范围清理测试缓存

确认需要让后续 package list mode 全部重新计算时，再执行：

# 只让已缓存的测试结果失效，不删除模块下载内容
go clean -testcache

# 查看 go clean 将处理的命令（不真正执行清理）
go clean -n -testcache

-testcache 和 -cache 不是一回事。前者针对测试结果，后者清理整个 Go build cache，影响重新编译；-modcache 则会清理模块下载缓存，通常不应为了一个“结果不变”现象使用它。清理之后再次运行 go test ./...，首轮没有 (cached) 并不代表测试一定通过，只能说明它重新执行了。

五、建立本地与 CI 的检查清单

本地开发可以让缓存承担提速角色，提交前或 CI 则要把“是否需要真实重跑”写进命令，而不是依赖手动删除目录。一个简单的检查顺序是：先看执行路径，再看是否出现 (cached)，用 -count=1 做对照，最后才决定是否清理。

• 需要快速回归：使用 go test ./...，把 (cached) 当作可解释的命中信号。
• 需要验证刚生成的代码或环境变化：使用 go test -count=1 ./...。
• 怀疑历史测试结果干扰多个包：使用 go clean -testcache，不要顺手删除 GOMODCACHE。
• 测试依赖时间、随机数、外部文件或服务：把依赖显式注入，否则强制重跑也只能重复不稳定行为。

相关问题

为什么 go test 没有显示 (cached)？

可能是当前目录模式、测试失败、参数超出可缓存范围，或这次输入确实发生了变化。先用 package list mode 和固定包路径复现。

go clean -testcache 会删除模块吗？

不会。它只让测试结果失效；模块下载缓存由 -modcache 管理，构建缓存由 -cache 管理。

count=1 要不要长期写进 CI？

如果 CI 的目标是每次都真实执行测试，可以明确保留；如果希望利用缓存提速，则让普通回归使用缓存，并在关键变更或隔离任务中单独使用 -count=1。