Homebrew 是 macOS 安装 Go 最可靠方式，但需依次完成：确认并更新 Homebrew、正确配置 GOPATH 和 PATH、验证 which go 和 go env 避免系统旧版冲突。
Homebrew 是 macOS 上最可靠的包管理器，用它装 Go 不仅快，而且后续升级、切换版本都比手动下载 SDK 简单得多——前提是别跳过几个关键步骤。
确认 Homebrew 已安装并更新到最新版
很多人卡在这一步却以为是 Go 的问题。运行 brew --version 检查是否可用；如果报 command not found，先装 Homebrew：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。装完务必执行：
-
brew update（拉取最新 formula 列表） -
brew doctor（排查常见环境冲突，比如 /usr/local 权限异常）
没跑通这两条就直接 brew install go，极可能遇到 Error: go: no bottle available! 或编译失败。
用 brew install go 安装后必须配置 GOPATH 和 PATH
Homebrew 安装的 Go 二进制在 /opt/homebrew/bin/go（Apple Silicon）或 /usr/local/bin/go（Intel），但默认不自动加进 shell 的 PATH；更关键的是，Go 1.16+ 虽然默认启用模块模式，但很多工具（如 go install 第三方命令）仍依赖 GOPATH 下的 bin 目录。
立即学习“go语言免费学习笔记（深入）”；
在你的 shell 配置文件（~/.zshrc 或 ~/.bash_profile）里追加：
export GOPATH=$HOME/go export PATH=$PATH:$GOPATH/bin
然后执行 source ~/.zshrc（或对应文件）。漏掉这步，go install golang.org/x/tools/gopls@latest 这类命令会提示 “command not found”。
验证安装并检查实际生效的 Go 版本
别只信 go version 输出——它可能来自系统预装的旧版（macOS 12.3+ 自带 Go，路径在 /usr/bin/go），和 Homebrew 装的冲突。运行：
-
which go→ 应该返回/opt/homebrew/bin/go或/usr/local/bin/go -
brew info go→ 查看当前安装的版本和状态（注意 “Poured from bottle” 表示已正确安装） -
go env GOPATH→ 确认输出是你设的$HOME/go，不是空或系统路径
如果 which go 还是 /usr/bin/go，说明 shell 的 PATH 优先级没调对：把 export PATH=... 行挪到配置文件最顶部，或删掉系统自带 Go 的软链（不推荐删二进制本身）。
Homebrew 装 Go 最容易出问题的地方，从来不是安装命令本身，而是 PATH 加载顺序、shell 配置未重载、以及误以为“装完就自动全局可用”。多花三十秒核对 which go 和 go env，能省掉后面两小时查为什么 go mod 报错或 gopls 找不到。
