先确认Mac芯片类型：终端执行arch，输出arm64为Apple Silicon，amd64为Intel；必须下载darwin-arm64.pkg并验证go version含darwin/arm64，否则卸载重装；仅修改~/.zshrc配置GOROOT、GOPATH和PATH，并source生效；新项目建议设GO111MODULE=auto，CGO_ENABLED=1时需确保C库也为arm64架构。
确认你的Mac芯片类型再下载安装包
Apple Silicon（M1/M2/M3）和Intel芯片的Go二进制不兼容，装错会导致go version报错或命令根本不可用。别信“Rosetta能转译”——它可能让go跑起来，但go build产出的二进制会是x86架构，无法原生运行在ARM设备上。
- 终端执行
arch：输出arm64就是Apple Silicon；输出amd64是Intel - 访问官网下载页时，优先用国内镜像（如 清华源），避免因网络中断导致.pkg下载不全
- 务必选择
darwin-arm64.pkg（非darwin-amd64.pkg），哪怕页面自动推荐了后者，也要手动切换
安装后必须检查darwin/arm64标识
双击.pkg安装完成后，go version 的输出里必须包含 darwin/arm64，这是原生支持的唯一可信证据。如果看到 darwin/amd64，说明你装错了包，或Homebrew误装了Intel版（尤其在通过brew install go且未清理缓存时）。
- 运行
go version，正确输出类似：go version go1.23.3 darwin/arm64 - 若显示
amd64，立刻卸载：sudo rm -rf /usr/local/go，再重下arm64版 - Homebrew用户额外执行
brew uninstall go && brew cleanup，防止旧版本残留干扰
环境变量配置只动~/.zshrc，别碰.bash_profile
macOS Catalina（10.15）起默认shell是zsh，.bash_profile已失效。改错文件会导致PATH没生效，终端始终提示command not found: go。
- 用
nano ~/.zshrc或code ~/.zshrc编辑，追加这三行： export GOROOT=/usr/local/goexport GOPATH=$HOME/goexport PATH=$PATH:$GOROOT/bin:$GOPATH/bin- 保存后必须运行
source ~/.zshrc，否则新开终端仍不认go - 验证：执行
echo $PATH，确认输出中含/usr/local/go/bin
初始化项目前先关掉GO111MODULE自动模式
新版Go默认开启模块（GO111MODULE=on），但某些老项目或CI脚本依赖GOPATH工作流，强行启用模块反而报go: cannot find main module。不是所有项目都适合开箱即用go mod。
立即学习“go语言免费学习笔记（深入）”；
- 新建项目时，先运行
go env -w GO111MODULE=auto（推荐）或=off（兼容旧习惯） - 想临时关闭模块：在项目目录下执行
export GO111MODULE=off再运行go run - 模块开启后，
go get会忽略GOPATH/src，直接拉取到pkg/mod，这点和旧版行为完全不同
最常被忽略的是：Apple Silicon上go install生成的可执行文件，默认就是arm64架构，但如果你用CGO_ENABLED=1调C库，必须确保对应C库也编译为arm64，否则运行时报bad CPU type in executable——这问题不会在go build阶段暴露，只在执行时崩。
