go build -x 暴露真实瓶颈在非编译环节，如 go list 扫描、sum.golang.org 校验超时、go:generate 重跑、cgo 调用等；加 -mod=readonly -trimpath -o 可显著提速并提升缓存复用率。
go build -x 显示的耗时步骤才是真瓶颈
别急着改代码或换工具，先执行 go build -x ./cmd/app 看输出。90% 的“编译慢”其实卡在非编译环节：go list 扫描模块树、sum.golang.org 校验超时（国内常卡 5–10 秒）、go:generate 无差别重跑、cgo 调用 gcc/clang、误用已废弃的 -a 或 -i 参数。
这些步骤和 Go 编译器本身无关，而是构建上下文混乱导致的。比如本地 replace 太多、go.mod 频繁变更、或路径里含中文/空格，都会让 go list 反复递归扫描。
必须加的三个参数：-mod=readonly -trimpath -o
不改一行代码就能提速，靠这组组合：
-
-mod=readonly：禁止自动修改go.mod，避免go mod tidy意外触发导致缓存失效 -
-trimpath：抹掉绝对路径信息，让相同源码在不同机器/目录下生成一致哈希，大幅提升$GOCACHE复用率 -
-o显式指定输出路径：防止 go build 默认写入临时目录，绕过缓存
日常开发直接用：go build -mod=readonly -trimpath -o bin/app ./cmd/app。CI 中可并行构建多个 binary：go build -mod=readonly -trimpath -o bin/a ./cmd/a && go build -mod=readonly -trimpath -o bin/b ./cmd/b。
立即学习“go语言免费学习笔记（深入）”；
缓存失效的静默陷阱：$GOCACHE 不是开了就有效
$GOCACHE 默认启用，但极易“静默失效”：
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
- 磁盘空间不足：运行
du -sh $(go env GOCACHE)查看实际占用，go clean -cache别乱跑 - Docker 构建未挂载：CI 中必须显式挂载
/root/.cache/go-build（Linux）或$HOME/Library/Caches/go-build（macOS） -
go run绕过缓存：它默认用临时目录编译，想走缓存得写成go build -o /tmp/a && /tmp/a - CGO_ENABLED 切换不共享缓存：
CGO_ENABLED=0和CGO_ENABLED=1的产物完全隔离
交叉编译也另开子目录，但只要 CGO 状态一致，缓存仍可复用。
只编译变更包：用 git + go list 做轻量级增量
大型项目中，单次修改通常只影响少数几个包。与其 go build ./ 全扫，不如精准定位：
查变更包：git status --porcelain | grep '\.go$' | xargs dirname | sort -u | xargs go list -f '{{.ImportPath}}'
只构建它们：go build $(上述命令)
注意点：
- 输出含
vendor/路径时需过滤，否则可能漏掉主模块外依赖 - 要求项目明确模块边界，不混用
replace和本地路径 - monorepo 场景下效果最明显，但需团队统一
go mod vendor或禁用 vendor
真正难的不是怎么快，而是怎么让每次构建都只做必要事——路径、代理、缓存、生成逻辑，全得对齐，缺一不可。
