go mod download卡在proxy.golang.org是因国内直连该默认代理不可达，需设goproxy=https://goproxy.cn,direct、go111module=on，并配套配置gosumdb=off（测试）或sum.golang.google.cn（生产），否则仅换代理仍会因校验失败中断构建。
go mod download卡在proxy.golang.org怎么办
这不是网络差，是默认代理不可达。Go 1.13+ 默认走 proxy.golang.org，国内直连基本失败，现象是命令无响应、几秒后报 dial tcp: i/o timeout 或直接 hang 住。
临时验证：执行 go env -w GOPROXY=direct 再跑 go mod download —— 若仍失败，说明连 GitHub 等源站也访问不了；若成功，就是代理问题。
- 必须同时设三项：
GO111MODULE=on（强制模块模式）、GOPROXY=https://goproxy.cn,direct（主镜像 + 回源）、GOSUMDB=off（关校验，测试环境）或GOSUMDB=sum.golang.google.cn（生产可用） - 别只配
GOPROXY：光换代理不关GOSUMDB，go build还会卡在sum.golang.org - CI 构建机建议用
GOPROXY=direct GOSUMDB=off，vendor 后仍需显式禁用校验，否则默认仍连远程
gopls、dlv 安装失败怎么绕过 IDE 卡死
VS Code 提示 “Install All” 但卡在 golang.org/x/tools，本质是 IDE 调用的 go install 没走你配好的代理环境变量。
Golang Spf13 Viper
下载
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
正确做法是手动安装，并确认当前 shell 已生效：
- 先运行
go env GOPROXY，输出必须是https://goproxy.cn,direct - 再执行
go install golang.org/x/tools/gopls@latest（Go 1.21+ 推荐） - 若仍卡在某个
golang.org/x/xxx子模块，可临时加 Git 替换：git config --global url."https://gitee.com/golang-x/".insteadOf "https://golang.org/x/"（仅限极个别镜像未同步场景）
checksum mismatch 错误怎么快速定位
报错 verifying github.com/xxx@v1.2.3: checksum mismatch，90% 不是代码被篡改，而是缓存、replace 冲突或镜像延迟。
- 第一步清缓存：
go clean -modcache，再重试go mod download - 检查
go.mod是否有残留replace指向本地路径但没删// indirect标记 - 避免全局设
GOINSECURE：它会让所有私有域名跳过校验，风险不可控；如需临时绕过单个模块，用go get -insecure github.com/xxx/yyy - 内网部署了 athens 或 goproxy.cn 镜像，却漏配
GOSUMDB，会导致拉代码成功但构建失败——错误日志里藏着fetching sum.golang.org
GOPROXY 和 GOSUMDB 配置容易被忽略的细节
很多人配了 GOPROXY 就以为万事大吉，结果 CI 失败、gopls 装不上、checksum 报错反复出现，问题常出在组合逻辑和作用域上。
-
GOPROXY=https://goproxy.cn,direct中的direct是 fallback，不是开关：它只在代理返回 404 或 410 时触发，不解决校验问题 -
GOSUMDB=off在离线/内网环境最安全；若要用校验，必须确保GOSUMDB地址能被 Go 工具链访问到，且与GOPROXY同域或互通 - Shell 配置文件（如
~/.zshrc）里写了export GOPROXY=...，但 VS Code 启动方式不加载该 shell，导致 IDE 里代理不生效——建议统一用go env -w写入全局配置 - 私有模块要加
GOPRIVATE，否则即使配了代理，Go 也会拒绝走GOPROXY，直接连私有 Git 服务器
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
