答案：go mod tidy卡住主因是私有路径未配置goprivate、gosumdb校验阻塞或gotoolchain版本不匹配。需用go list -m all定位私有模块，设goprivate覆盖全部域名，gosumdb=off临时绕过校验，并配gotoolchain=auto适配高版本依赖。
go mod tidy 卡在某个模块上不动
这不是网络卡顿，而是 Go 在尝试解析间接依赖时触发了私有路径或校验失败。常见现象是命令长时间无输出，go mod download -v 显示停在类似 github.com/internal/pkg 的地址上。
实操建议：
- 先运行
go list -m all看是否包含私有域名——若出现，说明GOPRIVATE没配全 - 临时关闭代理验证：执行
GOPROXY=direct go mod download -v，如果成功，问题出在代理链而非模块本身 - 检查
go env GOPRIVATE是否覆盖全部私有域，多个用逗号分隔，**不能有空格**，例如：git.example.com,github.com/my-org/* - 若私有库使用 SSH 路径（如
git@github.com:my-org/repo.git），需确保~/.ssh/config中已配置对应 Host 别名，否则go mod会静默失败
拉取 grpc@v1.79.1 报 “go >= 1.24.0 required”
你本地是 go1.23.5，但依赖要求更高版本，GOTOOLCHAIN=local 模式下 Go 不会自动切换工具链，直接报错。
实操建议：
- 执行
go env -w GOTOOLCHAIN=auto，之后go mod tidy会自动下载并使用go1.24+工具链 - 验证是否生效：运行
go version，输出应含go1.24.x或类似提示；也可看go env GOTOOLCHAIN是否为auto - 注意：该设置全局生效，若其他项目必须严格用
go1.23.5，可在项目根目录加.gotoolchain文件写入go1.23.5覆盖 -
GOTOOLCHAIN=auto不会修改系统已安装的 Go，只在当前命令生命周期内拉取并缓存所需版本
GOPROXY 配了还是 timeout 或 403
代理地址本身没问题，但失败常因 GOSUMDB 校验阻塞——Go 默认连 sum.golang.org 验签，而国内代理不提供 sumdb 服务，导致超时或被墙中断。
实操建议：
- 优先执行
go env -w GOSUMDB=off临时绕过校验，确认是否解决；若 OK，再考虑更安全的方案 - 推荐长期配置：
go env -w GOSUMDB=sum.golang.org+local+go env -w GONOSUMDB="git.example.com,github.com/my-org/*" - 检查
GOPROXY值中是否含direct作为 fallback，否则私有模块无法回退，例如：https://goproxy.cn,direct - VS Code 用户注意：终端可能未继承 shell 的环境变量，重启 VS Code 或在设置里启用
"terminal.integrated.env.linux"（或对应平台）手动注入
go.sum 缺失条目导致 go build -mod=readonly 失败
missing go.sum entry 不代表依赖没拉到，而是 Go 发现某个 require 条目在 go.sum 中没有对应哈希记录，拒绝构建。
实操建议：
- 不要手动编辑
go.sum—— 它由 Go 自动维护，手改会导致后续命令拒绝加载 - 运行
go mod download补全校验和，它会为所有require条目生成缺失的go.sum行 - 若
go.mod里有// indirect条目但go.sum缺失，说明该模块未被实际 import 触达，可先go mod tidy清理再重试 - CI 环境中此错多因缓存了旧
go.sum或未同步最新go.mod变更，确保构建前执行git checkout并清理 vendor（如有）
GOPRIVATE 漏一个域名、GOSUMDB 少一个 +local、GOTOOLCHAIN 还是 local，任何一个都会让后续步骤静默卡住。调试时别猜，用 go list -m all 和 go mod graph 看真实依赖图，比反复重试高效得多。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
