必须设置GOPROXY=https://goproxy.cn,direct等支持Go Module的国内镜像并保留direct关键字，否则私有模块解析失败、checksum mismatch或go install找不到命令；验证用go env GOPROXY和go list -m golang.org/x/net。
国内拉不到 golang.org/x/ 下的包，根本不用换源或改 hosts，直接设 GOPROXY 就行；但设错格式或漏掉 direct 会导致私有模块解析失败、checksum mismatch 或 go install 找不到命令。
为什么 go get golang.org/x/net 总是超时或 403
不是网络问题，是 Go 工具链默认用 https://proxy.golang.org，这个地址在国内多数情况下不可达。它不走系统 HTTP 代理（HTTP_PROXY），也不读取浏览器设置，只认 GOPROXY 环境变量。
-
GOPROXY必须显式设置，且值要包含支持 Go Module 的中文镜像，比如https://goproxy.cn - 不能只写一个地址，否则镜像临时故障就彻底卡死；推荐用逗号分隔多个源 +
direct，例如：https://goproxy.cn,https://goproxy.io,direct -
direct不是可选后缀，它是关键字——表示对匹配不到镜像的模块（如公司内网 Git 域名）自动直连，避免认证失败或 DNS 解析异常 - 验证是否生效：运行
go env GOPROXY，输出应含goproxy.cn；再试go list -m golang.org/x/net，毫秒级返回即成功
go install 找不到命令或装错版本怎么办
go install 在 Go 1.21+ 默认启用模块感知安装，但它对版本格式敏感，且不自动 fallback 到 latest，容易装空或装错分支。
- 必须指定完整路径和精确版本，例如：
go install github.com/swaggo/swag/cmd/swag@v1.8.10 - 查可用版本用：
go list -m -versions github.com/swaggo/swag - 带破折号的 tag（如
v2.0.0-alpha）必须用双引号包裹：go install "github.com/xxx/yyy@v2.0.0-alpha" - 确保
GOBIN已加入$PATH，否则装完也提示command not found - 如果之前装过旧版，先清缓存：
go clean -modcache，再重装，避免复用损坏的模块索引
遇到 verifying xxx: checksum mismatch 别急着关校验
这不是代理问题，而是本地模块缓存与镜像同步状态不一致导致的校验失败。全局禁用 -insecure 或设 GOINSECURE 会引入安全风险，尤其在 CI/CD 或多租户环境。
立即学习“go语言免费学习笔记（深入）”；
- 优先尝试清除本地缓存：
go clean -modcache，再重跑go get - 若仅某个模块出问题，可对该模块临时跳过校验：
go get -insecure github.com/xxx/yyy - 检查
go.mod是否误加了replace指向本地路径却没删// indirect标记——这会让 Go 错误计算 checksum - 私有模块域名若需跳过校验，应限定范围设
GOINSECURE=git.internal.company，而非*
最常被忽略的是 direct 的位置和作用：它必须写在 GOPROXY 值末尾，且不能被空格或换行截断；一旦缺失，所有非公开域名（包括 gitlab.example.com 这类）都会被强制转发到代理，而代理无法处理内网鉴权，直接报 404 或 timeout。
