如何在 macOS 的 zsh 终端中正确配置 Go 环境变量-Golang-PHP中文网

如何在 macOS 的 zsh 终端中正确配置 Go 环境变量

本文详解 macOS（M1/M2/M3 或 Intel）使用 zsh 时 go: command not found 的根本原因及完整解决方案，涵盖 GOROOT、GOPATH、PATH 的正确设置与验证步骤。

本文详解 macos（m1/m2/m3 或 intel）使用 zsh 时 `go: command not found` 的根本原因及完整解决方案，涵盖 goroot、gopath、path 的正确设置与验证步骤。

在 macOS 上通过官方 .pkg 安装包安装 Go 后，终端仍提示 zsh: command not found: go，通常并非 Go 未安装，而是环境变量未被 zsh 正确加载——尤其当你同时维护 ~/.bash_profile 和 ~/.zshrc 时，zsh 默认只读取 ~/.zshrc，而 ~/.bash_profile 中的配置完全被忽略。

关键问题在于：你当前的 ~/.zshrc 仅添加了 /usr/local/go/bin 到 PATH，但缺少两个必要前提：

GOROOT 未显式声明（虽多数情况可自动推导，但显式设置更可靠、可避免跨架构或自定义安装路径时的歧义）；
GOPATH 未设置，导致 go install 等命令无法定位可执行文件输出目录（如 go install hello@latest 默认会将二进制写入 $GOPATH/bin）。

✅ 正确配置（请编辑 ~/.zshrc）：

macOS Notes

通过 AppleScript 创建、读取、搜索及管理 macOS 备忘录。适用于用户要求记笔记、记录事项、保存想法、创建会议记录等场景。

下载

# Go 根目录（官方 pkg 默认安装路径）
export GOROOT=/usr/local/go

# 工作区路径（按 Go 官方推荐，建议设为 ~/go）
export GOPATH=$HOME/go

# 可执行文件输出目录（go install 默认目标）
export GOBIN=$GOPATH/bin

# 将 Go 工具链和用户二进制加入 PATH（顺序重要：GOROOT/bin 在前，GOBIN 在后）
export PATH=$GOROOT/bin:$PATH
export PATH=$GOBIN:$PATH

⚠️ 注意事项：

不要重复追加 :$PATH：原配置 export PATH=$PATH:/usr/local/go/bin 易导致 PATH 冗余膨胀；推荐 export PATH=$GOROOT/bin:$PATH，确保 go 命令优先被识别。
立即生效配置：运行 source ~/.zshrc，或新开一个终端窗口。

验证是否成功：

go version          # 应输出类似 go version go1.22.4 darwin/arm64
go env GOROOT GOPATH GOBIN  # 检查三者路径是否符合预期
echo $PATH | tr ':' '\n' | grep -E "(go|local)"  # 快速确认 PATH 包含 /usr/local/go/bin 和 ~/go/bin

若使用 Homebrew 安装（brew install go），GOROOT 通常为 /opt/homebrew/opt/go（Apple Silicon）或 /usr/local/opt/go（Intel），请用 brew --prefix go 确认后替换上述 GOROOT 值。