Mac装Go最省心方式是先装Homebrew，需先安装Xcode命令行工具、用官方脚本安装Homebrew并换国内镜像源；再brew install go后，必须配置GOPATH和PATH，确保go install工具可全局调用，并注意VS Code需从终端启动或配置~/.zprofile。
Homebrew没装就别急着装Go
Mac上装Go最省心的方式就是用Homebrew，但前提是它得先在你系统里跑起来。很多人卡在第一步：终端一敲 brew --version 就报 command not found: brew，然后去搜“Go安装失败”，其实问题根本不在Go。
- 先确认Xcode命令行工具已装：
xcode-select --install，点安装、等下载、点同意——跳过这步，Homebrew安装过程大概率卡在“Installing the Command Line Tools (expect a GUI popup)” - 再运行官方安装命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"（注意不是main分支，HEAD才是当前稳定入口） - 国内网络不稳时，浏览器打不开
raw.githubusercontent.com是常见现象；不用重装系统，直接换镜像源——但别手动改Ruby脚本，现在Homebrew是Bash驱动，换源要分两步：cd "$(brew --repo)"后执行git remote set-url origin https://mirrors.ustc.edu.cn/brew.git，再同理换homebrew-core的源
brew install go 之后，go version 能跑 ≠ 环境配好了
go version 输出正常只说明二进制文件能调用，不代表你的项目能编译、工具能安装、go install 出的命令能全局执行。很多人在写完第一个 hello.go 后，想装 gopls 或 delve，结果提示 command not found，根源就在 $GOPATH/bin 没进 PATH。
- Homebrew安装的Go，
GOROOT会自动设好（通常是/opt/homebrew/opt/go/libexec或/usr/local/opt/go/libexec），你不用手动指定，但别删掉它——VS Code的Go插件依赖这个路径找SDK -
GOPATH建议明确设为$HOME/go，并创建标准子目录：mkdir -p $HOME/go/{bin,src,pkg}；否则某些老工具（比如go get github.com/golang/mock/mockgen）可能静默失败 - 必须把
$GOPATH/bin加进PATH：echo 'export PATH=$PATH:$HOME/go/bin' >> ~/.zshrc，然后source ~/.zshrc；不加这句，go install编译出来的二进制永远只能在当前目录下用
go mod init 不报错，不等于项目能正常构建
新建项目时敲 go mod init example.com/hello 成功，接着写完 main.go 却 go run main.go 报错说找不到包，或者 go build 生成的可执行文件一运行就崩溃——这类问题往往和模块路径、本地依赖或CGO环境有关，而不是Go本身没装好。
- 确保你在项目根目录下操作，且该目录**不在
$GOPATH/src下**；Go Modules开启后，放错位置会导致Go误判为GOPATH模式，进而忽略go.mod - 如果代码里用了
cgo（比如调用C库），macOS默认不带gcc，需额外装：brew install llvm并设置CC环境变量，否则go build -buildmode=c-shared会直接失败 - 验证模块是否真生效：运行
go env GO111MODULE，输出应为on；若为auto，在非模块路径下可能退化回旧行为
VS Code里go extension提示“Failed to install tools”
这是新手最常截图发到论坛的问题，但原因几乎都一样：PATH没刷进GUI应用。终端里 go 和 gopls 都好使，可VS Code启动后却找不到命令——因为macOS的GUI程序（包括从Dock点开的VS Code）不读取 ~/.zshrc，只认 ~/.zprofile 或系统级环境变量。
- 简单解法：从终端启动VS Code，
code .；这样它继承当前shell的全部环境，99%的工具安装问题消失 - 长期方案：把PATH相关导出语句挪到
~/.zprofile（zsh用户）或~/.profile（bash用户），因为GUI app会读这个文件；别重复写在多个配置里，容易冲突 - 别点“Install All”硬刚——先运行
go install golang.org/x/tools/gopls@latest手动装核心工具，再让插件检测，比全自动更可控
真正容易被忽略的，是Homebrew安装Go后，GOROOT 实际指向的是 /opt/homebrew/opt/go/libexec 这类符号链接路径，而VS Code或某些CI脚本如果硬编码了 /usr/local/go，就会悄无声息地用错版本。检查方式很简单：go env GOROOT 和 which go 对着看一眼，比查十篇教程都管用。
