go build卡在downloading阶段并非代码问题，而是go模块解析机制遍历整个依赖图并反复校验远程模块所致；应执行go build -mod=readonly -x确认是否真在下载，清理缓存后预下载依赖，并确保vendor使用时显式加-mod=vendor参数。
go mod graph 显示几百行依赖，build 还卡在 downloading 阶段
这不是你项目写得差，是 Go 的模块解析机制在“诚实干活”：它会遍历整个依赖图，哪怕某个子模块只被测试文件引用，也会触发下载和校验。真正拖慢的不是代码量，而是 go mod tidy 和 go build 在解析间接依赖时反复访问远程仓库、验证 go.sum、比对版本约束。
- 先确认是否真在下载：执行
go build -mod=readonly -x，观察输出里有没有git fetch或GET https://行；有，说明某依赖的go.mod缺失或校验失败，Go 回退到网络拉取 - 检查
go.mod里有没有大量// indirect条目：这些是隐式引入的，往往来自测试依赖或旧版工具链残留，用go list -m -u all | grep indirect筛出来，逐个确认是否必要 - 别信 “删了
go.sum就能重来”：这只会让下次go mod tidy更慢——它得重新计算所有哈希。正确做法是go clean -modcache清缓存，再go mod download拉干净一份
vendor 目录建了，但 go build 依然联网
vendor 不是魔法开关，它只提供本地副本，不改变模块解析逻辑。Go 仍会按 go.mod 规则走路径查找，只要没明确告诉它“用 vendor”，它就默认走网络。
Go语言（Golang）1.26.0
下载
Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。
- 构建命令必须显式加
-mod=vendor：只运行go mod vendor不够，go build默认仍是-mod=readonly - 确保你在 module 根目录下执行：即当前目录有
go.mod，否则 Go 会降级为 GOPATH 模式，完全忽略 vendor - 检查 vendor 下是否有完整
go.mod：某些包（尤其老版本）没提交自己的go.mod，Go 就无法离线解析其依赖，会 fallback 到网络
如何识别并剔除“看似有用实则冗余”的依赖
Go 官方工具不分析 import 是否被实际调用，因为 init()、interface 实现、反射注册等都合法但静默。只能靠组合手段逼近判断。
- 先筛直接依赖：
go list -f '{{if not .Indirect}}{{.Path}}{{end}}' all，这是你主动 require 的，优先审查 - 注释掉
import _ "xxx"后跑go build -a -v：报错说明它在init()里注册了驱动或插件，不能删 - 单独查测试文件：
go list -f '{{.ImportPath}}' ./... | grep test，很多未用依赖藏在*_test.go里，上线前应移除或用//go:build !test隔离 - 第三方扫描可提速：
gofnd或go-unused能扫 AST，但对 interface 实现、嵌入类型、反射调用无能为力，结果要人工复核
replace 和 go mod edit 强制升级后，怎么验证真生效了
写了 replace 或用 go mod edit -require=... 改了版本，不代表构建时就用了那个版本——路径拼错、版本格式不对、或被其他依赖的约束覆盖，都会让修改失效。
- 立刻执行
go build -a -v，看输出里编译的是哪个路径和版本号；如果还出现旧版路径，说明 replace 没命中 - 用
go list -m golang.org/x/net查当前解析出的版本，对比go.mod里写的是否一致 - 关键验证点：
go mod why golang.org/x/net，它会打印该模块被谁引入、走哪条路径，确认你强制指定的版本是否成了最终选择 - 注意 MVS（最小版本选择）机制：即使你
require了 v0.17.0，但若某个依赖硬性要求 ≤v0.14.0，Go 仍会锁定 v0.14.0——这时得用replace绕过，而不是反复改require
init() 注册、或实现某个 interface 供框架反射调用，删掉它不会让 build 报错，但会让 runtime panic。真正要花时间的，是厘清每个依赖在启动链、运行时扩展点、测试隔离中的真实角色。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
