Mac配置Go环境变量需先确认安装路径(官方pkg为/usr/local/go/bin,Homebrew按芯片选/opt/homebrew/bin或/usr/local/bin),再在~/.zshrc中添加对应PATH并source生效;建议同时设置GOPATH=$HOME/go并将其bin目录加入PATH开头。
mac 上配置 go 环境变量路径,核心是让系统能全局识别 go 命令,并支持模块下载、二进制安装等操作。关键不在于“写多少行”,而在于路径加对、顺序合理、生效及时。
确认 Go 安装位置再配 PATH
先弄清 Go 装在哪,再决定加哪条路径:
- 用官方
.pkg安装 → 默认路径是/usr/local/go,可执行文件在/usr/local/go/bin - 用 Homebrew 安装 → 实际路径类似
/opt/homebrew/Cellar/go/1.22.5/libexec(Apple Silicon)或/usr/local/Cellar/go/1.22.5/libexec(Intel),但 Homebrew 会自动创建软链接到/opt/homebrew/bin/go或/usr/local/bin/go
验证方式:运行 which go 或 brew --prefix go,输出的路径末尾带 /bin 或指向 /bin/go 的那个目录,就是你要加进 PATH 的路径。
编辑 shell 配置文件(zsh 为主)
macOS Catalina(10.15)起默认用 zsh,所以改 ~/.zshrc:
- 打开终端,运行
nano ~/.zshrc - 在文件末尾添加(按你实际路径选一行):
• 官方 pkg 安装:export PATH="/usr/local/go/bin:$PATH"
• Homebrew 安装(Apple Silicon):export PATH="/opt/homebrew/bin:$PATH"
• Homebrew 安装(Intel):export PATH="/usr/local/bin:$PATH" - 保存退出(
Ctrl+O → Enter → Ctrl+X),然后运行source ~/.zshrc生效
GOPATH 不强制设,但建议保留
Go 1.16+ 默认启用模块(GO111MODULE=on),新建项目不用依赖 GOROOT 或 GOROOT。但设一个 GOPATH 仍有实用价值:
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
-
go install编译出的命令(如gopls、stringer)默认放$GOPATH/bin,加进PATH就能直接用 - 兼容老项目或 CI 脚本中硬编码的路径
- 推荐写法(加在
~/.zshrc同一位置):export GOPATH=$HOME/goexport PATH="$GOPATH/bin:$PATH"
注意:$GOPATH/bin 必须放在 $PATH 开头或至少在系统路径之前,否则可能被覆盖。
验证是否生效
新开一个终端窗口(或运行 source ~/.zshrc),执行:
-
go version→ 应显示版本号,不报command not found -
echo $PATH | tr ':' '\n' | grep 'go'→ 应能看到你添加的路径 -
go env GOPATH→ 应输出你设定的路径(如/Users/xxx/go)
如果 VS Code 或其他 GUI 工具里 go 命令仍不可用,需在编辑器设置里启用“继承 shell 环境”,或手动在 ~/.zshrc 中补全 PATH 并重启应用。










