根本原因是Go Modules默认每次构建都走网络解析依赖树，尤其含大量indirect或私有模块时，go list -m all阶段易超时；解决方案包括配置GOPRIVATE、使用go build -mod=vendor跳过网络、清理未用依赖及优化vendor体积。
go build 耗时长，90% 不是编译器慢，而是卡在依赖解析阶段——尤其是 go list -m all 反复走网络、拉私有模块失败、或 vendor 与 mod 混用导致逻辑冲突。
为什么 go build 总是卡在 resolve phase？
根本原因不是代码量大，而是 Go Modules 默认每次构建都重新解析整个依赖树，哪怕你只改了一行 main.go。
- 私有模块（如
git.internal.company.com/go/lib）没配GOPRIVATE，go会先去 proxy 查，超时后才 fallback 到 vcs，单个模块就卡 5–10 秒 -
go.mod里有大量indirect依赖，尤其来自全量中间件包（比如github.com/grpc-ecosystem/go-grpc-middleware），但实际只用了其中 1 个拦截器 - CI 中既执行了
go mod download，又跑go build，两者都会触发同一套 resolve 流程，纯属重复劳动 - 本地开了
http_proxy但代理不稳定，go在每个模块上重试 3 次，耗时指数级增长
如何让 go build 完全离线、只读 vendor？
go build -mod=vendor 不是“启用 vendor”，而是“强制禁用网络 + 忽略 go.mod 中所有远程路径”，它信任 vendor 目录里的每一行代码。
- 先确保 vendor 干净可用：
go mod vendor -v（加-v看进度，避免静默失败） - 构建命令必须显式带上：
go build -mod=vendor -o service ./cmd/service - 如果项目用了
replace指向本地路径（如replace example.com/lib => ../lib），-mod=vendor会直接忽略它——必须先把replace对应的代码也go mod vendor进来，或改用GOPRIVATE+go mod tidy - CI 中推荐组合：
GO111MODULE=on CGO_ENABLED=0 go build -mod=vendor -ldflags="-s -w"，关掉调试信息和 cgo 能再省掉链接阶段 20%+ 时间
哪些依赖该删、哪些必须锁死？
微服务里拖慢编译的从来不是业务代码，而是泛型工具库和“全家桶式”中间件。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 检查是否导入了全量包却只用一小部分：比如
import "github.com/grpc-ecosystem/go-grpc-middleware"→ 改成import "github.com/grpc-ecosystem/go-grpc-middleware/v2/interceptors/logging" - 找出未被引用的依赖：
go list -m all | xargs -I{} sh -c 'go list -f "{{len .Imports}}" {} 2>/dev/null || echo {}'，配合go mod tidy清理 - 基础协议库（如
google.golang.org/protobuf、golang.org/x/net）必须锁死主版本：require google.golang.org/protobuf v1.34.1，否则 MVS 算法在多服务间可能选出不同次版本，引发隐性不一致 - 别信 “这个库很小”，
github.com/miekg/dns看似轻量，但它带了完整 zone parser，go list -m all解析时仍要递归拉它的全部间接依赖
vendor 目录变大后，磁盘 I/O 成瓶颈怎么办？
vendor 超过 50MB 后，go build 读取文件耗时明显上升，尤其在 WSL2 或 NFS 上——这不是 Go 的问题，是 OS 层面遍历数万个文件的开销。
- 禁止 vendor 里包含测试文件：
go mod vendor -exclude="**/*_test.go" -exclude="**/testdata/**" - 删掉 vendor 下的
.git和.github目录（它们常被意外带入），一行命令就能减掉 10–20MB - 如果项目用 Docker 构建，把
vendor/加进.dockerignore，避免 COPY 整个目录再解压 - 真正关键的点：不要为了“看起来干净”而频繁
go mod vendor。一次生成后，除非明确需要更新依赖，否则别碰它——vendor 是缓存，不是源码
复杂点在于，这些优化必须组合生效：只配 GOPRIVATE 不关网络，只清 indirect 不用 -mod=vendor，或者 vendor 里塞满测试文件——任一环节漏掉，编译时间就打回原形。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
