正确配置 GOPROXY 需包含多个镜像加 direct（如 https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct），内网需禁用 direct 并设私有代理及 GONOPROXY 白名单，同时配合 GOSUMDB=off 或内网校验服务。
直接设 GOPROXY=https://goproxy.cn,direct 就能解决 90% 的国内模块拉取失败问题，但单设一个镜像、漏掉 direct 或忽略私有模块配置，反而会让构建更不稳定。
go env -w GOPROXY 必须带 fallback 和 direct
Go 1.21+ 默认值是 https://proxy.golang.org,direct，但 proxy.golang.org 在国内基本不可用。不能只写 https://goproxy.cn —— 它偶尔返回 404（比如新 tag 还没同步），而 Go 不会在 404 后自动 fallback，命令直接失败。
- 正确写法：
go env -w GOPROXY=https://goproxy.cn,https://mirrors.aliyun.com/goproxy/,direct -
,是分隔符，Go 按顺序尝试，直到第一个返回成功响应（非 4xx/5xx） -
direct必须放在最后：它表示“所有代理都失败时，退回到直连源站（如 GitHub）”，不是可选项 - 验证是否生效：
go env GOPROXY输出应含goproxy.cn；再跑go list -m github.com/go-sql-driver/mysql，毫秒级返回即成功
内网环境必须禁用 direct 并部署私有代理
公司内网机器通常无法直连 GitHub 或 GitLab 公网，此时 direct 不是兜底，而是故障点。go build 会卡在 verifying xxx: checksum mismatch 或连接超时，因为 sum.golang.org 也访问不了。
- 先关校验：
go env -w GOSUMDB=off（仅临时调试）或部署内网sum.golang.google.cn镜像 - 代理必须覆盖全部依赖：
go env -w GOPROXY=http://my-goproxy.internal.company.com（注意用http://，部分内网代理不支持 HTTPS upstream） - 私有模块（如
git.internal.company.com/mylib）需额外加白：go env -w GONOPROXY=git.internal.company.com，否则代理会尝试转发导致认证失败 - CI 流水线中务必提前执行
go mod download -x验证所有模块能否被代理命中，避免上线时才发现缺失
go get / go install 时版本和 insecure 的坑
即使代理配置正确，go get 仍可能报 checksum mismatch，常见于镜像同步延迟、本地 modcache 污染，或私有模块用了自签名证书。
初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。
立即学习“go语言免费学习笔记（深入）”；
- 不要全局设
GOINSECURE，限定范围更安全：go env -w GOINSECURE="git.internal.company.com" - 临时绕过校验只对当前命令有效：
go get -insecure github.com/xxx/yyy -
go install必须带精确版本：go install github.com/swaggo/swag/cmd/swag@v1.8.10，@latest可能拉到不兼容的 master 分支 - 含破折号的版本号（如
v2.0.0-alpha）要用双引号包裹：go install "github.com/xxx/yyy@v2.0.0-alpha"
虚拟机或容器里别留 GOPATH 和 go.work 冗余配置
虚拟机里残留的 export GOPATH= 或从宿主机复制来的 go.work 文件，会导致模块查找路径错乱，表现为 cannot find module providing package 或依赖版本不一致。
- 删掉
~/.bashrc或/etc/profile中手动写的export GOPATH=行；go env GOPATH应输出默认路径（如/home/user/go） - 检查项目根目录是否有
go.work，若有，确认里面use ./xxx指向的是容器内路径，不是/mnt/share/xxx这类宿主机挂载路径 - 容器镜像建议用
golang:1.21-alpine起手，避免 Alpine 默认禁用 IPv6 导致http.ListenAndServe(":8080")绑定失败
最常被忽略的是 GONOPROXY 和 GOSUMDB 的组合策略：私有模块既要跳过代理转发，又要跳过远程校验，二者缺一不可；而 direct 在公网环境是保险丝，在内网却是断路器——得看清楚你到底在哪张网里干活。
