根本原因是goproxy配置被覆盖或未生效：go优先读取环境变量，vscode终端若未继承系统环境则代理不生效；需环境变量+go env -w双保险，并确保vscode从已加载配置的终端启动。
为什么 GOPROXY 配置后还是下载失败？
根本原因往往不是没配，而是配置被覆盖或未生效：Go 命令行优先读取环境变量，其次才是 go env -w 写入的设置；VSCode 的终端若未继承系统环境，或用了非登录 shell（如某些 Linux 发行版默认的 zsh 配置不全），go 命令就看不到你设的代理。
验证是否真生效，别只看 go env GOPROXY 输出，直接运行：
go list -m -f '{{.Dir}}' golang.org/x/tools 如果仍卡住或报 Get "https://proxy.golang.org/..." dial tcp: i/o timeout，说明代理根本没走通。
- 检查当前 shell 是否加载了你设置的环境变量（比如在
~/.zshrc里 export 了，但 VSCode 启动时没 source） - 在 VSCode 内置终端中运行
echo $GOPROXY，确认输出是你设的地址（如https://goproxy.cn,direct） - 避免只用
go env -w GOPROXY=...—— 它只写进 Go 的用户级配置，不保证所有子进程都继承
推荐配置方式：环境变量 + go env -w 双保险
VSCode 中 Go 扩展（如 golang.go）依赖 go 命令行为，而命令行为受环境变量驱动。最稳的方式是让环境变量落地到 VSCode 启动环境里。
- macOS / Linux：把
export GOPROXY=https://goproxy.cn,direct加到~/.zshrc（或~/.bash_profile），然后重启 VSCode（不是仅重启终端） - Windows（WSL）：同上，确保 WSL 的 shell 配置文件已更新；若用 PowerShell，则需在
$PROFILE中加$env:GOPROXY="https://goproxy.cn,direct" - Windows（原生）：用「系统属性 → 高级 → 环境变量」添加用户变量
GOPROXY，值为https://goproxy.cn,direct，重启 VSCode - 再补一道保险：执行
go env -w GOPROXY=https://goproxy.cn,direct，防止某些场景下环境变量未传入
GOPROXY 值怎么选？别硬套网上过时教程
国内可用的公开代理不止一个，但稳定性差异大。目前（2024 年中）实测可靠的是：
-
https://goproxy.cn：阿里云维护，响应快，支持 module proxy 和 sum database（GOSUMDB可设为sum.golang.google.cn或留空由其自动 fallback） -
https://proxy.golang.org在国内多数地区已不可靠，单独使用大概率超时 - 多个代理要用英文逗号分隔，且必须包含
direct作为兜底，例如：https://goproxy.cn,https://proxy.golang.org,direct—— 注意顺序：前面的优先，失败才试下一个 - 如果公司有私有 proxy（如 Nexus 搭建的 Go repo），把它放在最前，
direct仍要保留，否则私有包无法 fallback 到本地 vendor 或 replace
VSCode 里 Go 扩展提示“no packages”或“import not resolved”怎么办？
这通常不是 GOPROXY 本身问题，而是 Go 扩展缓存或模块模式未正确识别导致的连锁反应。
- 先确认项目根目录有
go.mod文件；如果没有，运行go mod init your-module-name - 在 VSCode 终端中执行
go mod tidy，观察是否成功拉取依赖；失败时看具体错误——如果是verifying github.com/xxx@v1.2.3: checksum mismatch，可能是GOSUMDB冲突，临时关掉试试：go env -w GOSUMDB=off（仅调试用，勿长期关闭） - VSCode 右下角状态栏点 Go 版本号，确认显示的是你预期的 Go 安装路径（尤其当装了多个 Go 版本时）
- 重启 VSCode 的 Go 语言服务器：Cmd/Ctrl + Shift + P → 输入 “Go: Restart Language Server”
真正容易被忽略的是：VSCode 启动方式。从桌面图标、Spotlight 或开始菜单启动的 VSCode，默认不会加载 shell 的 profile，所以即使 .zshrc 里写了 export GOPROXY，它也看不见。必须从已加载配置的终端中运行 code . 启动，或者在设置里开启 "terminal.integrated.inheritEnv": true（但该选项对 GUI 启动的 VSCode 无效）。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
