根本原因是模块环境残留错误代理、校验配置或旧缓存；需检查goproxy是否为https://goproxy.cn,direct，验证go list -m -u all连通性，清理mod缓存、重置环境变量并重建go.mod/go.sum。
go mod tidy 为什么总拉错版本或卡住
根本原因不是命令本身有问题，而是当前模块环境残留了错误的代理、校验配置或旧缓存。go mod tidy 只负责按 go.mod 和代码 import 推导依赖，它不会主动清理外部干扰项。
- 检查
go env GOPROXY是否为https://goproxy.cn,direct或其他可用国内代理；若返回空或https://proxy.golang.org，说明代理未生效 - 运行
go list -m -u all测试连通性：卡在某个模块、超时或报dial tcp: i/o timeout，基本可断定代理失效 -
go.sum被手动修改过？别碰它——Go 工具链会自动重写，强行编辑会导致后续go mod download拒绝校验 - 私有模块（如
git.internal.company.com/lib）没加进GONOPROXY和GONOSUMDB，也会让 tidy 卡在 404 或 checksum mismatch
一键清空模块缓存并重置代理配置
这不是“一键脚本”，而是三步确定性操作，每步都对应一个明确污染源。执行后能确保 go mod 命令从干净状态重新开始。
- 删模块缓存：
rm -rf $(go env GOPATH)/pkg/mod—— 这是必须的，go clean -modcache有时漏删部分子目录 - 重置代理（推荐持久化）：
go env -w GOPROXY=https://goproxy.cn,direct GONOPROXY="" GONOSUMDB=""—— 清空私有配置，避免残留域名干扰 - 删掉项目根目录下的
go.mod和go.sum，再重新go mod init your-module-name—— 不要跳过这步，旧文件可能含已弃用的 replace 或 exclude 规则
为什么 go get github.com/xxx 仍然慢或失败
go get 在模块模式下本质是触发依赖解析+下载，它的行为完全受当前环境变量和模块配置约束，不是独立工具。
- 确认是否在项目根目录下执行——如果不在，go get 会尝试创建新模块，或往 $GOPATH 下装包，行为不可控
- 别用
go get -u：Go 1.16+ 已弃用该 flag，升级依赖请用go get xxx@v1.2.3或go get xxx@latest - 遇到
checksum mismatch错误，不要删go.sum，先检查GONOSUMDB是否与GONOPROXY值一致；不一致就必然失败 - Windows 用户注意：PowerShell 中
$env:GOPROXY="https://goproxy.cn,direct"设置后需重启终端，cmd 和 PowerShell 环境不共享
重装 Go 后依赖还是不对怎么办
重装 Go SDK 不等于重置模块环境——GOROOT 变了，但 GOPATH/pkg/mod、shell 配置、IDE 缓存全都没动，这才是最常被忽略的“脏状态”。
- 执行
which go和go env GOROOT，确认二者指向新安装路径；否则旧 bin 可能还在 PATH 里 - 搜遍
~/.bashrc、~/.zshrc、/etc/profile，删掉所有硬编码的GOROOT=、GOPATH=行 - VS Code 或 GoLand 必须重启，它们启动时读取的是旧 shell 环境，改完配置不重启 IDE 就白改
- 最后跑一次
go mod download -x（加-x显示详细请求 URL），看实际走的是哪个代理地址，这才是最终依据
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
