国内用户需显式配置 goproxy 为多个国内镜像（如 https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/）并以 direct 结尾，确保顺序尝试失败后可直连；企业内网则应移除 direct 并仅保留可信代理，同时配合 goprivate、goinsecure 等变量处理私有模块。

国内用户直接用默认 GOPROXY（https://proxy.golang.org,direct）大概率会卡在 go mod download 或 go get，因为 proxy.golang.org 在国内不稳定，且 404 不触发 fallback——必须显式配置可用镜像并保留 direct 作为末尾兜底。

如何设置 GOPROXY 环境变量才真正生效

改完环境变量不生效，八成是没刷新或被 IDE 缓存干扰。

• 先验证当前值：go env GOPROXY，别只信配置文件里写了什么
• Linux/macOS：写进 ~/.zshrc（或 ~/.bashrc），然后 source ~/.zshrc；别漏掉 source
• Windows PowerShell：临时生效用 $env:GOPROXY="https://goproxy.cn,direct"；永久设置必须走「系统属性 → 环境变量」图形界面，PowerShell 的 [Environment]::SetEnvironmentVariable 只对当前用户有效，且需重启终端
• GoLand/VS Code 可能读取自身缓存：改完后执行 go clean -modcache，再重启 IDE

为什么不能只配一个代理地址

GOPROXY 是顺序尝试机制，不是负载均衡——遇到 404 或 503 就停，不会自动 fallback 到 direct，除非它排在最后。

Go语言（Golang）1.26.0

Go语言（Golang）1.26.0版本提供 Go 官方 Windows amd64 MSI 安装包下载入口，版本号 1.26.0，可用于旧项目维护、兼容性测试和指定版本开发环境配置。

下载

• 错误写法：go env -w GOPROXY=https://goproxy.cn → 遇到模块未缓存或 CDN 失效时直接报 404 Not Found，命令退出
• 正确写法：go env -w GOPROXY=https://goproxy.cn,https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct → 前两个镜像失败后，才走 direct 直连 GitHub/GitLab
• 逗号必须是英文，不能有空格；direct 必须小写、无协议、置于末尾
• 企业内网禁用 direct？那就只留可信代理，例如 go env -w GOPROXY=https://my-goproxy.internal.company.com，并提前用 go mod download -x 验证所有依赖是否可命中

私有模块怎么避免被公共代理转发

不加控制，gitlab.example.com/mylib 这类地址会被发往 goproxy.cn，要么 404，要么暴露内网路径甚至认证信息。

• 必须设 GOPRIVATE=gitlab.example.com（支持通配符，如 *.example.com），Go 才跳过代理直连
• 若私有库用 SSH（git@gitlab.example.com），还需配 ~/.netrc 或 git config --global core.sshCommand
• 若私有模块无 HTTPS 证书或走 HTTP，得补 GOINSECURE=gitlab.example.com，否则 TLS 握手失败
• GONOSUMDB 要同步设，否则校验失败：go env -w GONOSUMDB=gitlab.example.com

go build 时走代理，但业务代码 HTTP 请求不走代理

这是两套机制：GOPROXY 只管模块下载，不影响你代码里的 http.Client。

• HTTP_PROXY 和 HTTPS_PROXY 环境变量只影响 go 命令自身（如 go get），不自动注入到你的 http.DefaultClient
• 想让业务请求走代理，必须手动配置 transport：http.Transport{Proxy: http.ProxyURL(&url.URL{Scheme:"http", Host:"127.0.0.1:7890"})}
• SOCKS5 代理要换函数：http.ProxyURL 不支持，得用 golang.org/x/net/proxy 的 SOCKS5 构造器
• 临时调试可命令前加环境变量：HTTPS_PROXY=http://127.0.0.1:7890 go run main.go，不影响全局

最容易被忽略的点：私有模块域名没加进 GOPRIVATE，却指望 direct 自动兜底——其实 direct 只对公开 HTTPS 仓库有效，SSH 或自签名 HTTPS 私有库必须靠 GOPRIVATE + GOINSECURE 组合才能绕过代理和校验。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！