如何在Mac芯片架构下安装Golang_Golang Apple Silicon安装方案

先确认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/go
• export GOPATH=$HOME/go
• export 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阶段暴露，只在执行时崩。