90%的模块依赖构建变慢源于模块下载、校验、缓存失效或误用构建参数；设goproxy=https://goproxy.cn,direct、goprivate=私有域名，加-mod=readonly和-trimpath参数即可恢复秒级响应。
模块依赖构建变慢，90%不是 Go 编译器的问题，而是模块下载、校验、缓存失效或构建参数误用导致的——改对三个环境变量和两个命令参数，就能让 go build 回到秒级响应。
为什么 go build 第一次总卡在 go mod download
根本原因是默认代理 proxy.golang.org 在国内 TLS 握手常超时，单次卡 5–10 秒，且不走缓存。Go 会逐个拉取 go.mod 里所有模块（含 transitive 依赖），每模块都触发一次校验请求。
- 执行
go mod download -x可看到真实卡点：日志里反复出现GET https://proxy.golang.org/...就是没走代理 - 必须设
GOPROXY=https://goproxy.cn,direct，,direct不能省，否则私有模块（如git.internal.company.com/lib）会失败 - 配套运行
go env -w GOPRIVATE=git.internal.company.com，否则 Go 仍会把私有路径发给公共代理 - 验证是否生效：运行
go mod download -x github.com/gin-gonic/gin@v1.9.1，输出中必须含goproxy.cn而非proxy.golang.org
go build 重复执行还是慢，缓存没命中？
Go 的构建缓存（$GOCACHE）是内容寻址的，但很多操作会静默绕过它——不是缓存坏了，是输入不一致。
- 避免用
-a或-i：这两个参数强制重编所有依赖（包括标准库），Go 1.12+ 已废弃，CI 脚本里残留是常见原因 - 日常构建加
-mod=readonly和-trimpath：go build -mod=readonly -trimpath -o bin/app ./cmd/app，前者防go mod tidy意外触发，后者让不同路径下源码哈希一致 - 交叉编译（如
GOOS=linux go build）会分独立缓存目录；但混用CGO_ENABLED=0和CGO_ENABLED=1会导致缓存完全不共享 - 检查缓存是否真在用：加
-v参数，输出里出现cached字样才说明命中；若全是building，大概率是参数或环境变了
大型项目里改一行代码，为什么整个项目重编？
因为默认 go build ./... 会扫描全部包，尤其当项目含 //go:embed、大量 internal/ 包或 cgo 时，go list 阶段就耗时数秒。
- 只编译变更包：用
git status --porcelain | grep '\.go$' | xargs dirname | sort -u | xargs go list -f '{{.ImportPath}}'获取变动路径，再go build $(上条命令) - 禁用无差别
go:generate：把它从go build流程里剥离，改用make proto或just gen显式触发 -
embed路径别写**/*.html：递归扫描所有子目录会拖慢go list，精确写成./templates/*.html - 开发期别开
echo.Debug = true这类调试开关：它们会抑制内联、增加逃逸分析负担，间接拉长编译链
CI/CD 中构建持续变慢，磁盘和路径陷阱
CI 环境里 $GOCACHE 容易“静默失效”，表现是每次构建都从零开始，但日志看不出错。
- Docker 构建必须挂载缓存目录：
-v /path/on/host:/root/.cache/go-build，否则容器退出即丢缓存 - 检查磁盘空间：
du -sh $(go env GOCACHE)，若满或为 0，缓存机制自动停摆 -
go run默认不走$GOCACHE，它用临时目录；CI 中要测构建速度，必须用go build -o /tmp/a && /tmp/a - 某些 CI 平台（如 GitHub Actions）默认清空
$HOME，需显式配置actions/cache缓存$GOCACHE和$GOMODCACHE
真正卡住的地方，往往不是“换哪个镜像站”，而是 GOPROXY 是否被所有子进程继承、,direct 是否漏写、GOPRIVATE 是否覆盖全部私有路径——这三个点错一个，go build 就会退回到默认代理，白配。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
