根本原因是path未包含go的bin目录；先运行which go或where go确认路径，再执行/usr/local/go/bin/go version验证，若成功则说明仅需将对应bin路径加入shell配置并source生效。
go version 报 command not found 怎么快速定位
根本原因不是 Go 没装好，而是系统找不到 go 二进制文件。Mac/Linux 默认解压到 /usr/local/go/bin，但该路径常未加入 PATH；Windows 安装器若没勾选“Add to PATH”，也会出现同样问题。
- 先运行
which go（macOS/Linux）或where go（Windows），看是否返回路径；没输出就说明 PATH 没配对 - 检查
go实际位置：Mac 上通常是/usr/local/go/bin/go，Windows 默认是C:\Go\bin\go.exe - 临时验证：直接执行
/usr/local/go/bin/go version，能成功就确认是 PATH 问题 - 修复方式：把对应
bin目录加进 shell 配置（~/.zshrc或~/.bash_profile），再source生效
GO111MODULE=on 和 GOPROXY 必须设吗
必须设，且顺序不能反。Go 1.16+ 虽默认开启模块模式，但某些旧脚本、CI 工具或 IDE 插件仍依赖显式声明；而没配 GOPROXY 会导致 go mod download 卡在 golang.org/x/ 包上，尤其在国内网络环境下几乎必现。
- 执行
go env -w GO111MODULE=on确保模块启用，避免go.mod不生成或依赖错乱 -
go env -w GOPROXY=https://goproxy.cn,direct是国内最稳组合，direct表示对私有域名跳过代理 - 不要用
export GOPROXY=...写 shell 配置——go env -w才写入 Go 自己的配置，不受终端会话影响 - 验证：运行
go env GOPROXY，输出应为"https://goproxy.cn,direct"
多版本 Go 共存时 GOROOT 还要不要手动设
绝大多数情况不用，设了反而容易出错。Go 安装包自带的 go 可执行文件会自动推导 GOROOT，只要 PATH 指向的是你想要的版本，它就能找到自己的标准库。
- 只有当你解压多个 Go 版本（比如
/opt/go1.20、/opt/go1.22）且不改PATH时，才需靠GOROOT切换版本 - 错误设置
GOROOT的典型表现：运行go build报cannot find package "fmt" - 更推荐用
asdf或gvm管理多版本，它们通过符号链接控制PATH，比硬编码GOROOT更可靠 - 检查当前值：
go env GOROOT输出应和which go的上级目录一致；不一致就删掉GOROOT环境变量
VS Code Go 插件总提示“install tools”失败怎么办
本质是插件试图调用系统 go 命令安装 gopls、goimports 等工具，但环境变量没被正确继承，或者代理没生效。
- 不要点插件弹窗里的 “Install All” —— 它走的是插件内置逻辑，常忽略你设的
GOPROXY - 手动在终端运行：
go install golang.org/x/tools/gopls@latest，确保GOPROXY已生效 - VS Code 的
settings.json中加"go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn" }，让插件启动时带代理 - 重启 VS Code 后按
Cmd+Shift+P（Mac）或Ctrl+Shift+P（Win/Linux），搜 “Go: Install/Update Tools”，再全选安装 - 如果仍失败，检查
$HOME/go/bin是否在PATH中 —— 这些工具默认装到这里，VS Code 必须能访问
go env 或 shell 配置后，VS Code 不重启就不会加载新值；还有 go mod init 时模块路径写成本地绝对路径（如 go mod init /home/user/proj），会导致后续所有 import 失败，且错误信息非常隐蔽。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
