如何在Mac芯片架构下安装Golang_Golang Apple Silicon安装方案-Golang-PHP中文网

先确认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芯片架构下安装golang_golang apple silicon安装方案

确认你的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。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

用 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 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阶段暴露，只在执行时崩。