go build 变慢主因是 gocache 被设为 off 或空值导致缓存失效;其次为缓存目录占满、多用户/ci 共享缓存引发权限冲突,以及交叉编译和 cgo_enabled 状态变化导致缓存键不匹配。

Go build 为什么越来越慢?先查 GOCACHE 是否被禁用
很多项目在 CI 或本地反复构建时变慢,不是代码问题,而是 GOCACHE 被设成了 off 或空值。Go 1.10+ 默认启用构建缓存,但一旦环境变量显式设为 GOCACHE=off(常见于某些 Dockerfile 或旧脚本),所有 go build、go test 都会跳过缓存,重新编译全部依赖。
-
GOCACHE=off是硬关闭,比没设变量还糟——后者会 fallback 到默认路径 - 检查方式:运行
go env GOCACHE,输出应是类似/Users/me/Library/Caches/go-build的有效路径,而非off或空 - Docker 中容易踩坑:基础镜像里没清理掉旧的
ENV GOCACHE=off,或构建阶段误继承了宿主机的错误配置
缓存目录磁盘占满导致构建失败:看 go build -x 输出里的 cache 路径
当 go build 突然报错如 write /path/to/cache/xxx: no space left on device,不是 Go 本身出错,而是缓存目录所在分区满了。Go 不会自动清理旧缓存,尤其在频繁切换分支、测试不同 Go 版本时,缓存体积可能达数 GB。
- 确认缓存位置:
go env GOCACHE,然后du -sh $(go env GOCACHE) - 安全清理:用
go clean -cache,它只删构建缓存,不影响go mod download的 module cache - 别手动
rm -rf缓存目录——Go 进程可能正写入,导致后续构建静默失败或 hash 校验不一致
多用户或 CI 共享构建缓存:必须设独立 GOCACHE 路径
同一台机器上多个用户、或 CI runner 复用工作区时,如果共用默认 GOCACHE,会出现权限冲突或缓存污染。比如用户 A 构建的 net/http 缓存对象,用户 B 读取时因 UID 不同被拒绝访问,报错 cache access denied。
- 推荐做法:按用户或 job ID 设唯一路径,例如
GOCACHE=$HOME/.cache/go-build-$(id -u) - CI 场景下更稳妥:用 job 唯一标识,如
GOCACHE=/tmp/go-cache-$CI_JOB_ID(GitLab)或GOCACHE=/tmp/go-cache-$GITHUB_RUN_ID(GitHub Actions) - 注意
/tmp在某些容器中是内存盘,容量小;若缓存体积大,得挂载持久卷并设对应路径
交叉编译和 CGO_ENABLED=0 会影响缓存命中率
Go 缓存键(cache key)包含目标平台(GOOS/GOARCH)、CGO 状态、编译器版本等。哪怕只改一个 GOOS=linux,就生成全新缓存条目,不会复用 GOOS=darwin 的结果。这对 CI 多平台构建影响明显。
立即学习“go语言免费学习笔记(深入)”;
- 常见误操作:在同一个缓存目录下交替执行
GOOS=linux go build和GOOS=darwin go build,缓存体积翻倍且无共享 - CGO_ENABLED=0 会触发纯 Go 实现的 stdlib 编译路径,缓存完全隔离——即使 GOOS/GOARCH 相同,
CGO_ENABLED=0和CGO_ENABLED=1的缓存互不兼容 - 优化建议:CI 中为不同平台/CGO 组合分配独立缓存目录,或使用
go clean -cache定期清理不用的组合
缓存不是“设了就一劳永逸”的开关,它的有效性高度依赖路径隔离、权限一致和构建参数稳定性。最容易被忽略的是:不同 CGO 状态之间绝对不共享缓存,连提示都没有,只会默默重建。










