go 1.13+ 默认启用 goproxy，但国内需手动设为 goproxy.cn 或阿里云镜像并保留 direct 兜底；私有模块须同步配置 goprivate 和 gonosumdb；临时禁用代理可用 goproxy=direct 前缀；排查下载慢需检查 .netrc、git config 及网络劫持。
Go 1.13+ 默认启用了 GOPROXY，但国内仍需手动设为国内镜像
Go 1.13 起默认启用 GOPROXY=https://proxy.golang.org,direct，但该地址在国内常超时或返回 403。不改代理，go get、go mod download 等操作大概率卡在 fetching 或直接失败。
必须显式设置为可用的国内代理，且建议保留 direct 作为兜底（用于私有模块或未被镜像覆盖的域名）：
-
go env -w GOPROXY=https://goproxy.cn,direct（推荐，由七牛云维护，稳定、全量、支持校验） -
go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct（阿里云镜像，响应快，但偶有同步延迟） - 避免使用已停更或不可靠的地址，如
https://goproxy.io（2023 年底已停止服务）
需要跳过代理的私有模块必须用 GONOSUMDB 和 GOPRIVATE
设了 GOPROXY 后，所有模块默认走代理下载，但公司内网 Git、GitHub 私有库、GitLab 自建实例等无法被公开代理拉取。此时会报错：module github.com/your-org/internal-lib: reading https://goproxy.cn/github.com/your-org/internal-lib/@v/list: 404 Not Found。
解决方法是明确告诉 Go 哪些模块不走代理：
立即学习“go语言免费学习笔记（深入）”；
-
go env -w GOPRIVATE=git.example.com,github.com/your-org/*（支持通配符*） -
go env -w GONOSUMDB=git.example.com,github.com/your-org/*（跳过校验，否则因无 checksum 会报checksum mismatch） - 这两项必须同时设置，缺一不可；路径前缀不能带协议（如不要写
https://git.example.com）
临时禁用代理只对单条命令生效：用环境变量前缀
调试时想绕过代理直连（比如验证某个模块是否真在私有 Git 上、或排查代理本身问题），不需要全局改 GOPROXY，更安全的做法是命令前加环境变量：
-
GOPROXY=direct go list -m all：跳过代理查当前模块树 -
GOPROXY=https://goproxy.cn go get github.com/sirupsen/logrus@v1.9.0：仅本次用指定代理，不影响全局 - 注意：Windows PowerShell 中要用
$env:GOPROXY="direct"，而 CMD 是set GOPROXY=direct && go list ...
go proxy 配置生效后仍下载慢？检查 GOPROXY 是否被 .netrc 或 git config 覆盖
即使 go env GOPROXY 显示正确，go get 仍卡住，常见原因是 Git 层面的凭据或重定向干扰：
- 检查
~/.netrc是否存在且含错误的machine proxy.golang.org login ...条目（Go 会读它并尝试认证） - 运行
git config --global --get-all url."https://".insteadOf，确认没有把https://强制替换成git://或其他不可达协议 - 某些企业网络会劫持 HTTPS 请求并返回 HTML 页面（而非 404），导致 Go 解析失败；此时可加
-v参数看详细日志：go get -v github.com/pkg/errors
代理配置本身很简单，真正麻烦的是各种隐式覆盖和网络中间件的干扰——调不通时，先看 go env 输出，再看 go get -v 的实际请求路径，最后查 Git 凭据和网络策略。
