// indirect 表示间接依赖，由 Go Modules 自动推导出，非直接 import 但需锁定版本以保证构建可重现；它参与构建和测试，不可手动删除，升级应通过 go get 或 go mod tidy 处理。
go get -u 升级后为什么 go.mod 里出现 // indirect 且无法编译？
直接跑 go get -u 不是升级，而是“盲目拉取最新主版本”，常导致间接依赖（// indirect）被意外引入或降级，破坏最小版本选择（MVS）。Go 不会自动校验这些依赖是否真被用到，更不会检查 API 兼容性。
实操建议：
- 禁用全局
-u：永远用go get path@version显式指定目标版本，比如go get github.com/sirupsen/logrus@v1.9.3 - 升级前先运行
go list -m -u all，只看可升级项，不执行；注意输出中带[newest]的才是安全候选 - 升级后立刻执行
go mod tidy，它会删掉未引用的// indirect行——但前提是你的代码真没用到那些包 - 若
go build报错如undefined: xxx，大概率是新版 API 变了，得查该模块的 CHANGELOG 或 diff 它的go.mod中require的子依赖变化
怎么写 shell 脚本批量检测并生成升级 PR 的 diff？
核心不是“自动升级”，而是“可控比对”：先锁定当前 go.sum 和 go.mod，再生成干净的升级后快照，只提交差异部分。
实操建议：
- 用
go list -m -json all > before.json记录当前所有模块状态，包括Version和Indirect字段 - 对每个待升级模块，用
go get path@latest（非-u）单独升级，再go mod tidy，避免连带污染 - 用
git diff --no-index /dev/null go.mod | grep '^+' | grep '=>' | awk '{print $2}'提取新增/变更的版本号，比对before.json确认是否为预期变更 - 脚本末尾必须加
go mod verify校验 checksum 是否全部有效，失败则 abort，防止因代理缓存脏数据导致后续构建失败
CI 中怎么让依赖升级 PR 自动跑兼容性检查？
不能只跑 go test ./...，很多 breakage 在编译期就暴露了，但测试可能跳过边缘 case。重点是拦截 ABI 不兼容变更。
实操建议：
- 在 CI step 里插入
go build -o /dev/null ./...，比go test更早发现 import path 错误、函数签名消失等硬错误 - 用
gopls check（需提前go install golang.org/x/tools/gopls@latest）扫描未使用的 import 或类型推导失败，它比go vet更敏感 - 对关键依赖（如
grpc-go,sqlx），加白名单校验：解析go list -m -json path输出，强制要求Version符合正则^v1\.[0-9]+\.[0-9]+$，拦住 v2+ 的 major bump - 别信
go.mod里的replace—— CI 必须在 clean env 下运行，删掉本地replace后再go mod download，否则漏掉真实网络依赖问题
为什么 go mod graph 查出的依赖链和实际 runtime 加载的不一致？
go mod graph 展示的是模块图（module-level），而 Go 运行时加载的是包级路径（package-level），两者粒度不同。一个模块含多个包，但 graph 只画模块节点，不反映具体 import 了哪个子包。
实操建议：
- 查真实依赖链用
go list -f '{{.Deps}}' package/path，它输出的是该 package 直接 import 的所有包路径，不含间接模块 - 若要定位某函数调用来源，用
go tool trace配合runtime/pprof捕获 stack trace，而不是靠graph猜 -
go mod graph中出现循环箭头（A → B → A）说明有 module 循环 require，这是非法状态，go build会报错，必须拆分模块或改用replace临时解耦 - 注意
go mod graph不显示 vendor 内容——如果项目用了go mod vendor，得额外跑find vendor -name "*.go" | xargs grep "import.*github"手动核对
