go version验证失败主因是PATH未生效，而非未安装：Linux/macOS需确认~/.zshrc等文件中PATH含实际go bin路径并source；Windows需在系统环境变量Path中添加C:\Go\bin并重启终端。
go version 验证失败的常见原因
输入 go version 报错或返回“command not found”，说明 PATH 没生效，不是 Go 没装好，而是 shell 找不到 go 二进制文件。
- Linux/macOS：检查
~/.bash_profile、~/.zshrc或/etc/profile是否真写了export PATH=$PATH:/usr/local/go/bin（路径必须和实际安装位置一致） - Windows：确认系统环境变量里
Path包含的是C:\Go\bin，不是C:\Go；且重启了终端（cmd/PowerShell 不继承已修改但未重启的环境变量） - macOS M1/M2 芯片用户注意：若用 Homebrew 安装，
goroot可能是/opt/homebrew/opt/go/libexec，不是/usr/local/go，PATH必须对应
GOPROXY 必须设，否则 go mod download 卡死
国内直接连 proxy.golang.org 基本超时，go get 或 go mod tidy 会卡在 “Fetching modules…”，等几分钟后报错 timeout 或 no matching versions。
- 推荐设置为
go env -w GOPROXY=https://goproxy.cn,direct（direct是 fallback，确保私有模块仍可拉取） - 避免只写一个代理，比如
https://goproxy.io已停服，单独用会失败 - 企业内网需走私有代理时，
GOPRIVATE必须同步配置，例如go env -w GOPRIVATE=git.internal.company.com/*
GOROOT 和 GOPATH 的现代用法差异
Go 1.16+ 默认启用 module 模式，GOPATH 不再决定项目根目录，但仍有实际作用；GOROOT 则几乎不用手动设——除非你装了多个 Go 版本并想切换。
-
GOROOT：通常由安装程序自动设好，运行go env GOROOT看输出即可，99% 场景下无需干预 -
GOBIN（不是 GOPATH/bin）才是go install工具的实际落地目录，建议显式设为$HOME/go/bin并加入PATH，否则gopls、goimports等 VS Code 插件依赖的工具可能找不到 -
GOPATH仍影响go install的默认行为，且 VS Code Go 插件会读它来定位工具，不设容易导致 “command not found” 类提示
VS Code Go 插件启动失败的硬性依赖
插件报错 “Failed to find ‘gopls’”，不是插件问题，而是底层工具链缺失。VS Code 的 Go 扩展默认不会自动安装全部工具，尤其在禁用自动更新或离线环境下。
立即学习“go语言免费学习笔记（深入）”；
- 手动触发安装：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入 “Go: Install/Update Tools”，全选后确认 - 关键工具必须存在：
gopls（语言服务器）、goimports（格式化）、golangci-lint（静态检查）——缺一不可 - 如果
go env GOPATH是空值，工具会装到$HOME/go/bin，但 VS Code 可能没把这个路径加进PATH，导致找不到，此时需在 VS Code 设置里显式指定"go.gopath"或修正系统PATH
PATH 后没新开终端，或设了 GOPROXY 却没跑 go mod tidy 测试拉包，结果问题拖到写业务代码时才暴露。 
