go version 显示旧版是因 path 中存在多个 go 安装路径导致冲突；go env -w goproxy 失效常因 go111module 未启用或代理 url 缺少 ,direct；go 1.16+ 后 gopath 无需手动设置，仅用于存放 go install 工具；vs code 卡在安装工具是因默认尝试安装已废弃组件，应仅选 gopls、goimports、dlv、gomodifytags。
go version 命令报错或显示旧版本
说明：安装新版本 Go 后，go version 仍显示旧版（比如系统残留的 Chocolatey 安装、WSL 中的旧版、或 PATH 中多个 go 可执行文件冲突），这是 Windows 和 macOS 上最常被忽略的路径污染问题。
实操建议：
- 运行
where go（Windows PowerShell）或which go（macOS/Linux）确认实际调用的是哪个二进制文件 - 检查
$env:Path（PowerShell）或$PATH（bash/zsh）中是否包含多个 Go 安装路径，如C:\Go\bin和C:\Users\XXX\scoop\apps\golang\current\bin - 优先保留官方 MSI 安装路径（
C:\Go\bin），删掉其他路径；若用 scoop/choco，卸载前先执行scoop uninstall golang或choco uninstall golang - 重启终端（不是仅关掉窗口，而是彻底关闭再新开），否则环境变量不会刷新
go env -w GOPROXY 失败或代理不生效
说明：go env -w GOPROXY=https://goproxy.cn,direct 看似成功，但后续 go mod download 仍超时，常见原因是 Windows 默认启用 GO111MODULE=auto 且未显式启用模块模式，或代理 URL 被防火墙拦截但无明确报错。
实操建议：
- 先运行
go env GO111MODULE，如果不是on，必须执行go env -w GO111MODULE=on - 设置代理时务必包含
,direct后缀，否则私有模块无法拉取；不要写成https://goproxy.cn单独一个值 - 验证代理是否真起作用：新建空目录，运行
go mod init example.com/test && go get github.com/go-sql-driver/mysql@v1.7.0，观察是否秒级完成 - 若仍失败，临时改用
go env -w GOPROXY=https://proxy.golang.org,direct测试——能通说明是国内镜像源网络策略问题，而非配置本身
GOPATH 还需要手动设置吗
说明：很多教程仍在教设 GOPATH，但 Go 1.16+ 默认开启模块模式后，GOPATH 仅用于存放 go install 生成的二进制（如 gopls、dlv），不再决定项目位置。强行设错反而导致 VS Code 插件找不到工具。
实操建议：
- 除非你明确要用
go install安装 CLI 工具并希望它们出现在$GOPATH/bin，否则无需设置GOPATH - 若要设，只设
GOPATH，不要设GOROOT（MSI 安装已自动配置，手动设反而易出错） - VS Code 中如果提示 “Command ‘Go: Install/Update Tools’ failed”，大概率是
GOPATH没写对，或$GOPATH/bin不在PATH中 - 推荐路径：Windows 设为
C:\Users\用户名\go，macOS/Linux 设为$HOME/go，然后确保%GOPATH%\bin或$GOPATH/bin在PATH里
VS Code Go 扩展反复提示 “Installing tools” 卡住
说明：这是因 Go: Install/Update Tools 默认尝试安装全部 15+ 个工具（包括 guru、golint 等已废弃组件），而其中部分工具依赖旧版 golang.org/x/tools，在模块代理未生效或网络受限时无限等待。
实操建议：
- 打开命令面板（
Ctrl+Shift+P），输入Go: Install/Update Tools，**不要全选**，只勾选以下 4 个核心项：gopls、goimports、dlv、gomodifytags - 安装前确认
go env GOPROXY输出正确，且终端能正常go get golang.org/x/tools/gopls - 若仍卡住，手动安装：
go install golang.org/x/tools/gopls@latest，然后重启 VS Code - 禁用自动安装：在 settings.json 中加
"go.toolsManagement.autoUpdate": false，避免每次启动都触发
go mod 拉不到包、gopls 启动失败、VS Code 提示“no workspace”，这些问题几乎都卡在环境变量叠加顺序、代理 fallback 机制、以及工具链版本与 Go 主版本的兼容性上——而不是“没装对”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
