在 macOS 上搭建 Go 开发环境只需三步：安装 Go、配置 GOPATH 和 PATH 环境变量、验证 go version/go env/go run 是否正常；推荐官网 pkg 安装并编辑 ~/.zshrc，避免 brew 或手动覆盖。

在 macOS 上搭建 Go 开发环境其实很直接，核心就三步：安装 Go、配置环境变量、验证是否可用。只要路径和权限设对，基本不会出问题。

下载并安装 Go

去官网 https://www.php.cn/link/81836b7cd16991abb7febfd7832927fd 下载最新版 macOS 安装包（通常叫 goX.X.X.darwin-arm64.pkg 或 darwin-amd64.pkg）。双击运行安装程序，默认会把 Go 安装到 /usr/local/go。安装完成后终端里还不能直接用 go 命令，需要手动配置路径。

配置 GOPATH 和 PATH

macOS 默认用 zsh（从 Catalina 开始），所以要编辑 ~/.zshrc 文件：

echo 'export GOPATH=$HOME/go' >> ~/.zshrc
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.zshrc
echo 'export PATH=/usr/local/go/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

说明：

立即学习“go语言免费学习笔记（深入）”；

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

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

下载

• GOPATH 是你存放 Go 项目、依赖和编译产物的根目录（默认是 $HOME/go），建议保持默认
• PATH 中 go 的二进制路径必须前置，即 /usr/local/go/bin 要放在最前面或至少在其他可能冲突的 Go 路径之前
• 如果你用的是 bash（旧系统或自己改过），就改 ~/.bash_profile

验证安装是否成功

终端输入：

go version
go env GOPATH
go env GOROOT

正常会输出类似：

go version go1.22.3 darwin/arm64
/Users/yourname/go
/usr/local/go

再试一个简单命令确认工作流没问题：

go mod init hello && echo 'package main; func main(){println("ok")}' > main.go && go run main.go

如果打印出 ok，说明环境已就绪。

基本上就这些。不需要额外装 IDE，但推荐用 VS Code 配上 Go 扩展，自动补全和调试体验很好。注意别用 brew install go 来装，容易和系统路径冲突；也别手动解压覆盖 /usr/local/go，pkg 安装器更稳妥。