Go编译慢90%源于缓存未被正确利用：需验证GOCACHE路径及大小，检查go build -x是否出现cached，避免go run、go clean -cache、CGO_ENABLED混用、CI未挂载等导致缓存失效，并推荐使用-mod=readonly、-trimpath等参数提升命中率。
Go 编译慢，90% 不是 Go 本身的问题，而是缓存没被正确利用或被意外绕过。 检查 GOCACHE 是否启用、是否被清理、是否在交叉编译或 go run 场景下静默失效，比调参数更管用。
怎么确认 GOCACHE 是否真在工作
缓存路径默认存在但可能“形同虚设”：磁盘满、CI 未挂载、或被 go clean -cache 清掉。别猜，直接验证：
- 运行
go env GOCACHE查路径，再用du -sh $(go env GOCACHE)看实际大小——空目录或0B就说明没生效 -
go build -x ./cmd/app输出里搜cache或go-build，如果出现cached或reusing表示命中；若全是building和临时/tmp/go-build路径，说明缓存被跳过 -
go run main.go默认不走GOCACHE，它用的是临时目录——想测缓存必须用go build -o /tmp/a && /tmp/a
哪些操作会悄悄让 GOCACHE 失效
缓存不是“设了就一劳永逸”，几个常见动作会让它彻底作废：
- 执行
go clean -cache—— 非必要绝不运行，尤其 CI 脚本里残留这条要立刻删掉 - 频繁修改
go.mod（比如反复加删replace或require），会导致模块校验哈希变化，GOCACHE命中率暴跌 - 混用
CGO_ENABLED=1和CGO_ENABLED=0构建同一项目——它们的缓存完全隔离，无法复用 - 在 Docker 构建中没挂载
/root/.cache/go-build（Linux）或/Users/xxx/Library/Caches/go-build（macOS）到宿主机，每次都是新缓存
日常构建必须加的三个参数
不改代码、不换工具，加这三项就能立竿见影提升缓存复用率：
立即学习“go语言免费学习笔记（深入）”；
-
-mod=readonly：禁止go build自动触发go mod tidy或修改go.mod，避免因隐式变更导致缓存失效 -
-trimpath：抹掉源码绝对路径信息，让同一份代码在不同机器、不同路径下生成一致的哈希，大幅提升跨环境缓存命中率 -
-buildmode=archive（仅调试时）：跳过链接阶段，只生成.a文件，比完整构建快 3–5 倍，适合验证包能否编译通过
推荐组合：go build -mod=readonly -trimpath -o myapp ./cmd/myapp
CGO 场景下缓存特别容易断链
只要涉及 import "C"，缓存就多一层脆弱性——C 侧变更不会被 Go 编译器自动感知，容易误判“无需重编”：
- C 源文件（
.c）、头文件（.h）或CGO_CFLAGS变更后，go build不会自动触发重编，必须手动清掉_obj目录或用go build -a（但-a已废弃，慎用） - 把 C 代码提前编译成静态库（如
libmy.a），然后用CGO_LDFLAGS="-L. -lmy"链接，能让 Go 侧变更不再牵连 C 编译 -
CGO_ENABLED=0构建时生成的缓存，和CGO_ENABLED=1的完全不共享——交叉编译时尤其注意，别指望 Linux 下编译的缓存能用在 Windows 上
真正卡住你的，往往不是编译器速度，而是你以为它在缓存、其实它在重头编译。盯住 go build -x 输出里的路径和关键词，比背参数有用得多。
