GoLand 本身不直接管理 GOPROXY，需在系统或终端中配置环境变量，GoLand 启动时继承该值；macOS/Linux 要确保 GUI 应用加载 shell 配置，Windows 需设系统级环境变量并重启 IDE。
GoLand 里配置 GOPROXY 需要改哪里
GoLand 本身不直接管理 GOPROXY，它依赖系统级或项目级的 Go 环境变量。真正起作用的是你在终端或系统中设置的 GOPROXY 值，GoLand 的构建/运行/依赖下载流程会继承这个环境变量。
如果你在终端执行 go mod download 能走私服，但在 GoLand 里失败，大概率是 GoLand 没读到你 shell 中设置的变量（尤其是 macOS/Linux 的 GUI 应用常不加载 ~/.zshrc 或 ~/.bash_profile）。
- Windows：检查系统环境变量是否已添加
GOPROXY，GoLand 启动前需重启资源管理器或整个 IDE - macOS：推荐在
~/Library/LaunchAgents/environment.plist中注入变量，或用 GoLand 的 Help → Edit Custom VM Options… 加-Denv.GOPROXY=...（仅对部分场景有效） - Linux：确保桌面环境启动 GoLand 时加载了 shell 配置，或直接从终端执行
goland &
私服需要认证时怎么传 token 或用户名密码
Go 官方不支持在 GOPROXY URL 里硬编码密码（如 https://user:pass@proxy.example.com），这种写法会被 Go 工具链主动过滤或拒绝，且存在泄露风险。
正确方式是使用 git 的凭证存储机制配合 netrc 文件，因为 Go 在拉取私有模块（尤其含 .git 后缀的模块路径）时会复用 git 凭据。
- 生成
~/.netrc（Windows 是%USERPROFILE%/_netrc），内容格式为：machine proxy.example.com login your-username password your-api-token
- 确保文件权限严格：
chmod 600 ~/.netrc（否则 Go 会忽略） - 如果私服基于 Nexus/Artifactory，确认其 Go 仓库启用了 “Anonymous Access” 关闭时仍允许 token 认证，并且模块路径与仓库路由匹配（例如
proxy.example.com/go/private对应module private.example.com）
为什么设置了 GOPROXY 还是 fallback 到 direct
Go 默认的 GOPROXY 值是 https://proxy.golang.org,direct，逗号分隔表示“逐个尝试，失败则 fallback”。如果你的私服地址写成 https://proxy.example.com 但没加 ,direct，一旦请求 401/404/超时，Go 就会跳过所有后续代理直接走 direct —— 此时它会尝试克隆原始 Git 仓库，而你很可能没配好 SSH key 或 git 凭据，导致报错 unknown revision 或 ref not found。
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 务必显式补全 fallback：设为
https://proxy.example.com,direct - 用
go env -w GOPROXY="https://proxy.example.com,direct"全局设置最稳妥，避免 IDE 启动环境不一致 - 验证是否生效：在项目根目录运行
go list -m all，观察日志中是否出现你的私服域名；也可临时设GOPROXY=https://invalid-url,direct看是否报错 403 而非静默 fallback
GoLand 控制台看不到代理请求细节怎么办
GoLand 默认隐藏 go 命令的底层网络日志，你无法直接看到它是否连了私服、返回了什么状态码。
临时启用调试输出的方法是：在 GoLand 的 Run → Edit Configurations… → Go Build → Environment variables 里添加：
-
GODEBUG=http2debug=1（看 HTTP/2 连接） -
GO111MODULE=on（确保模块模式开启） -
GOPRIVATE=private.example.com（告诉 Go 不要把该域名走代理，而是直连——注意这和GOPROXY配合逻辑相反，别误配）
更可靠的方式是切到终端，在项目下手动执行 go mod download -x，-x 会打印每一步的命令和 HTTP 请求详情，包括实际访问的 URL 和响应头。
真正容易被忽略的是：私服返回的 Content-Type 必须是 application/vnd.go-mod（或兼容的 JSON 格式），否则 Go 会当作无效响应而 fallback；另外，某些企业私服默认关闭了 /@v/list 和 /@v/vX.Y.Z.info 这类发现接口，必须手动开启才能支持 Go modules 协议。
