go clean 不是万能清洁剂，它只清理特定缓存且参数作用范围不同：-cache删编译中间产物（.a文件），-modcache删模块下载缓存（$GOMODCACHE），-testcache删测试结果缓存，无参数仅删当前包构建产物。
go clean不是万能清洁剂，它只清理特定缓存，且不同参数作用范围完全不同。用错参数不仅白忙活，还可能让构建变慢或失败。
go clean -cache 清的是编译中间产物，不是模块源码
它删的是 $GOCACHE 目录下的 .a 文件（编译生成的对象归档），用于加速重复 go build 和 go test。这些文件和你 go mod download 下来的模块源码完全无关。
常见错误现象：
-
go build突然变慢，或改了代码却没生效 - 切换
CGO_ENABLED、GOOS/GOARCH后链接失败但无明确报错 - CI 构建结果和本地不一致
实操建议：
- 执行前先确认路径：
go env GOCACHE，macOS 默认是$HOME/Library/Caches/go-build -
go clean -cache不会清空整个目录，只删“过期”条目；真要彻底清，得rm -rf $(go env GOCACHE)/*（注意末尾/*，别误删父目录） - 清理后首次构建会明显变慢——这是正常表现，缓存重建需要时间
- 如果用了
GOCACHE=off，该命令就什么也不做
go clean -modcache 清的是 $GOMODCACHE，不是 $GOPATH/src
它删的是模块下载缓存，即 $GOMODCACHE（默认为 $GOPATH/pkg/mod）里的所有解压源码、.zip 包和校验数据。这个操作和旧式 $GOPATH/src 手动 clone 的项目完全无关。
常见错误现象：
cannot find module providing package xxxverifying github.com/xxx: checksum mismatch-
go list -m all显示的版本和go.mod对不上
实操建议：
- 执行前务必确认
GO111MODULE=on，否则go clean -modcache静默无效 - 不要在发布前临时执行——清理后
go build会重新下载所有依赖，耗时不可控 - 若只想删某个模块，可手动
rm -rf $GOMODCACHE/github.com/xxx@v1.2.3 $GOMODCACHE/cache/download/github.com/xxx - 清理后建议立刻跑
go mod verify，确保后续拉取的模块和go.sum一致
go clean -testcache 只影响测试结果复用，不影响日志输出
它删的是测试结果缓存（存在 $GOCACHE 内，但路径前缀不同），让 go test 强制重跑，而不是直接返回 “cached”。这个缓存不存 t.Log() 或 panic 输出，那些本来就不缓存。
使用场景：
- 改了测试逻辑，但
go test还显示 “cached” - CI 中验证测试稳定性，需排除缓存干扰
- 怀疑测试通过/失败状态被污染
实操建议：
-
go clean -testcache和go clean -cache可同时运行：go clean -cache -testcache - 它不会触发重新编译，只是让测试框架跳过结果复用逻辑
- 如果想连编译也强制重来，加
-a：go test -a
go clean（无参数）只删当前包的构建产物，不碰缓存
它删的是当前目录下由 go build 或 go test -c 生成的可执行文件、.test 文件、_obj/、_test/ 等临时目录，以及匹配 *.[568ao] 的对象文件。它不删 $GOCACHE，也不删 $GOMODCACHE，更不删 go install 安装到 $GOBIN 的二进制。
实操建议：
- 日常开发中可安全执行，适合清理本地调试生成的临时二进制
- 要删
go install的产物，必须加-i，且go clean -i只删「当前目录 main 包」安装的文件 - 递归清理整个项目用
go clean ./...或go clean -r ./（注意-r是递归标志，不是所有 Go 版本都支持，1.19+ 推荐用./...） - 它不会删
testdata/目录，也不会动vendor/
真正容易被忽略的是：缓存路径不是固定值，go env GOCACHE 和 go env GOMODCACHE 必须每次执行前确认；而 go clean -modcache 在私有代理切换、磁盘异常中断 go get 后才真正必要，不是定期维护动作。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
