go 1.18 安装后需手动配置 gopath（推荐设为项目目录），老项目依赖 gopath 路径结构；goproxy 配置失效常见于 ide 环境未加载 shell 配置、脚本覆盖或逗号格式错误，应统一用 go env -w 设置并验证生效。
go env 显示 GOPROXY 已设置，但 go get 仍连不上 proxy.golang.org
说明你看到的 GOPROXY 值只是“当前 shell 环境”的配置，并不等于命令实际运行时生效的环境。常见原因包括：
- VS Code / GoLand 启动时未加载
~/.bashrc或~/.zshrc，导致 IDE 内终端和调试器读取的是空或旧的GOPROXY - 某些 Makefile、CI 脚本或容器环境里显式覆盖了
GOPROXY，比如写成GOPROXY=https://proxy.golang.org,direct（没换国内源） - GoLand 的 “Go Modules” 设置里勾选了 “Use GOPROXY environment variable”，但你改的是用户级变量，而 IDE 启动用的是系统级 shell（如 macOS 的 login shell），两者环境隔离
-
go env -w GOPROXY=...写入的是用户级配置，但若项目目录下有go.work或父目录存在go.mod，且该模块设置了//go:build ignore类似干扰项，也可能绕过代理逻辑
验证方式：在 VS Code 终端里直接运行 go env GOPROXY，再运行 go get -v github.com/gin-gonic/gin，看报错里实际请求的 URL 是不是你还看到 proxy.golang.org —— 如果是，说明 IDE 没读到你的配置。
设置了 https://goproxy.cn,direct 还是超时或 403
这不是代理地址写错了，而是 direct 部分被误触发。Go 会按顺序尝试每个代理，一旦前面的失败就 fallback 到下一个。但如果你的 GOPROXY 里用了空格或中文逗号，Go 解析失败后会退回到默认值 https://proxy.golang.org,direct，而不是你写的那个。
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 检查是否用了全角逗号、空格或换行：正确写法必须是
export GOPROXY=https://goproxy.cn,direct（英文逗号，无空格） - 确认没有其他地方覆盖：运行
go env | grep GOPROXY，输出应严格匹配你设置的值；如果显示为空或默认值，说明配置没生效 -
direct不是万能兜底：它只对公开仓库有效，遇到私有 GitLab、GitHub Enterprise 或需要认证的仓库，direct会直接失败，且不会提示“需要登录”，只会卡住或报git ls-remote错误 - 清华镜像（
https://mirrors.tuna.tsinghua.edu.cn/goproxy/）比goproxy.cn更稳定，尤其对带v0.0.0-时间戳版本的模块支持更好，建议优先用它
go get 成功但 go build 报 checksum mismatch
这和 GOPROXY 无关，是 GOSUMDB 校验失败。Go 默认从 sum.golang.org 获取校验和，国内无法访问，就会 fallback 到本地 go.sum 文件——但若该文件缺失、损坏或被手动修改过，就会报错。
- 临时绕过：运行
go env -w GOSUMDB=off（仅开发阶段，勿提交） - 推荐做法：设为国内可访问的校验服务，例如
go env -w GOSUMDB=sum.golang.org+insecure（允许不验证）或go env -w GOSUMDB=off+go mod download后手动核对go.sum - 更稳妥方案：配合
GOPRIVATE使用，比如公司内网模块用go env -w GOPRIVATE=git.example.com/*，再配GONOSUMDB=git.example.com/*，避免校验私有库 - 注意：
GOSUMDB=off不影响go.sum生成，只跳过远程校验；但若你删了go.sum又没关GOSUMDB，go build会直接失败
Windows 上 set GOPROXY 无效，WSL 里却正常
Windows 的 CMD/PowerShell 和 WSL 是两套完全独立的环境变量系统。你在 PowerShell 里 $env:GOPROXY="..."，只对当前 PowerShell 实例生效；关闭窗口就丢失。WSL 是 Linux 子系统，读的是自己的 ~/.bashrc。
- PowerShell 永久设置：运行
[Environment]::SetEnvironmentVariable("GOPROXY", "https://goproxy.cn,direct", "User") - CMD 永久设置：用系统属性 → “环境变量” 图形界面添加用户变量，别用
setx（它不刷新当前会话） - VS Code for Windows 默认启动 PowerShell，但若你装了 WSL 扩展并启用了 Remote-WSL，那所有终端和调试都走 WSL 环境，此时 Windows 的
GOPROXY完全不生效 - Git Bash 用户注意：它不读 Windows 环境变量，也不自动 source
~/.bashrc，需确认~/.bash_profile里有source ~/.bashrc
最不容易出错的做法：所有平台统一用 go env -w GOPROXY=...，它写入 Go 自己的配置文件，不受 shell 类型影响。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
