go clean -cache 删除的是 $GOCACHE 目录下已编译的中间产物(主要是 .a 文件),用于加速构建;改代码不生效常因缓存复用错误,如 CGO_ENABLED、GOOS/GOARCH 或 Go 版本变更后旧缓存未失效。

go clean -cache 删的是什么,为什么改了代码不生效
go clean -cache 清的是 $GOCACHE 目录下已编译的中间产物(主要是 .a 文件),不是源码,也不是模块。这些缓存让 go build 和 go test 跳过重复编译,但一旦源码、CGO_ENABLED 状态、GOOS/GOARCH 或 Go 版本变动,旧缓存可能被错误复用。
常见错误现象包括:go build 速度突然变慢、函数逻辑改了却没触发重新编译、CI 构建结果和本地不一致。
执行前建议确认路径:go env GOCACHE(macOS 默认是 $HOME/Library/Caches/go-build);go clean -cache 不会清空整个目录,只删“过期”条目;要彻底清,得用:rm -rf $(go env GOCACHE)/*(注意末尾 /*,别漏掉)。
如果设了 GOCACHE=off,这条命令什么也不会做。
什么时候必须手动清 $GOCACHE
不是每次构建慢都要清——缓存本身是加速机制,清了首次构建会明显变慢,属正常表现。
真正需要手动清理的场景有:
- 切换了
CGO_ENABLED值(比如从0切回1),否则链接阶段可能静默失败 - 升级 Go 版本后出现符号找不到、类型不匹配等奇怪报错(
go1.21+ 对构建环境变更更敏感,但旧缓存不会自动作废) - 磁盘空间告急,且
du -sh $(go env GOCACHE)显示占用超数 GB(尤其 macOS 用户常发现go-build占满/Users/xxx/Library/Caches/) - 运行
go build -a仍慢,但go clean -cache后恢复——说明缓存已损坏或磁盘 I/O 受限
别混淆:它和模块缓存、安装二进制完全无关
go clean -cache 不动 $GOMODCACHE(模块下载缓存)、$GOPATH/bin(安装的二进制)、$GOPATH/pkg(旧式安装缓存),三者互不干扰。
如果你遇到这些情况,说明你清错了地方:
-
cannot find module providing package xxx→ 应该用go clean -modcache -
go install生成的可执行文件删不掉 →go clean -i只清理「当前目录有main包」时安装的二进制,cd 错目录就无效 - 改了 C 代码但没重新链接 →
go clean -cache有效,但需确保CGO_ENABLED环境变量在构建时与缓存生成时一致
清理后首次构建变慢,但这是最可控的代价
清完 $GOCACHE 后第一次 go build 会重新生成所有 .a 文件,耗时取决于项目大小和 CPU 性能。这不是 bug,是缓存重建的必经过程。
真正容易被忽略的是:这个“慢”是可预期、可复现、且只发生一次的;而不清缓存导致的“逻辑未更新”,却是隐蔽、偶发、难定位的。尤其在 CI 中混用不同 GOOS 或 CGO_ENABLED 配置时,缓存污染比你想象中更常见。
golang免费学习笔记(深入):立即使用
在学习笔记中,你将探索golang的核心概念和高级技巧!











