go version 报 command not found 是因 homebrew 安装路径未加入 $path：apple silicon 需在 ~/.zshrc 加 export path="/opt/homebrew/bin:$path"，intel mac 改为 /usr/local/bin，改后执行 source ~/.zshrc。
brew install go 之后为什么 go version 还报 command not found
因为 Homebrew 安装的 go 默认放在 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），但你的 shell 没把对应路径加进 $PATH。
检查当前 $PATH 是否包含 Homebrew 的 bin 目录：
echo $PATH
常见错误现象：终端新开一个窗口后 go 就失效；或者 VS Code 终端里能用，iTerm 里不能用——本质都是 shell 配置没生效。
- Apple Silicon Mac：确保
~/.zshrc（或~/.zprofile）里有export PATH="/opt/homebrew/bin:$PATH" - Intel Mac：对应改成
/usr/local/bin - 改完别忘了
source ~/.zshrc或重启终端
go env -w GOPATH 和 GOROOT 要不要手动设
不需要。现代 Go（1.16+）默认 GOPATH 是 $HOME/go，GOROOT 是 Homebrew 安装路径（如 /opt/homebrew/Cellar/go/1.22.5/libexec），且 go 命令自己能识别，硬设反而容易冲突。
立即学习“go语言免费学习笔记（深入）”；
常见错误现象：go build 报 cannot find module providing package，或 go mod init 创建的 go.mod 里出现奇怪的本地路径——大概率是之前手动 go env -w GOPATH=... 留下的副作用。
- 用
go env GOPATH和go env GOROOT查真实值，别信配置文件里的旧设置 - 如果真要覆盖（极少数情况），优先用
GOENV=off临时绕过环境变量缓存，而不是长期-w -
GOROOT绝对不要手动设，Homebrew 升级 Go 后路径会变，设死就断
用 brew upgrade go 后项目编译失败，提示 undefined: xxx
Go 小版本升级（比如 1.21.x → 1.22.x）可能引入不兼容变更，尤其是标准库行为调整、弃用函数移除，或 go.mod 中 go 版本声明低于新工具链要求。
典型表现：go run main.go 成功，但 go test ./... 失败；或者 CI 里跑通，本地 brew 升级后挂了。
- 先运行
go version确认当前实际版本，再看go.mod第一行go 1.xx是否 ≤ 当前版本 - 如果
go.mod写的是go 1.19，而你用了 1.22，某些泛型约束或io行为可能已变 - 临时降级可用
brew install go@1.21 && brew unlink go && brew link go@1.21（注意：Homebrew 不默认保留旧版本，得提前装好）
vscode-go 扩展提示 “Failed to find ‘go’ binary”
VS Code 的终端和 GUI 启动方式加载的 shell 配置不同。即使你在 iTerm 里 go version 正常，VS Code 可能根本没读 ~/.zshrc。
最稳的解法不是改 VS Code 设置，而是让系统级能找到 go：
- 确认
which go输出路径是否在$PATH里；如果不是，用ln -s /opt/homebrew/bin/go /usr/local/bin/go软链（需 sudo） - 或者在 VS Code 设置里搜
go.goroot，手动填入go env GOROOT的输出值 - 避免用
go.alternativeTools指向 Homebrew Cellar 下带版本号的路径（如/opt/homebrew/Cellar/go/1.22.5/libexec），升级后立刻失效
路径拼错、软链没权限、GOROOT 指向 libexec 但漏掉 /bin/go 后缀——这几个点卡住的人最多。
