Homebrew 是 macOS 安装 Go 最稳妥方式,但需手动配置 PATH、禁用 GOROOT、设置 GOPROXY 代理,并注意升级后版本兼容性;Apple Silicon 路径为 /opt/homebrew/bin,Intel 为 /usr/local/bin。

Homebrew 装 Go 是最稳妥的 macOS 方式,但直接 brew install go 后常遇到 go 命令找不到、GOROOT 冲突、或 go mod 报错——根本原因是 Homebrew 安装的 Go 默认不自动写入 shell 环境路径,且可能与手动下载的 SDK 共存冲突。
确认 Homebrew 已就绪并更新到最新版
Homebrew 自身过旧会导致 go 公式不可用或安装低版本(如 1.20 之前),尤其在 Apple Silicon Mac 上易出兼容问题。
- 运行
brew --version,确保输出版本 ≥ 4.0.0 - 执行
brew update(不是upgrade)拉取最新 formula 清单 - 若提示 “Command not found: brew”,需先按官网指引安装:访问
https://brew.sh复制安装命令执行
安装 Go 并验证二进制位置
Homebrew 将 Go 安装到 /opt/homebrew/bin/go(Apple Silicon)或 /usr/local/bin/go(Intel),但不会自动添加到 $PATH —— 这是命令失效的主因。
- 执行
brew install go,等待完成 - 立刻检查安装路径:
which go,若为空,说明 shell 未加载 Homebrew 的 bin 目录 - 查看真实路径:
brew --prefix go(输出类似/opt/homebrew/opt/go),其bin/go才是可执行文件
手动配置 shell PATH(zsh 默认,非 bash)
macOS 10.15+ 默认使用 zsh,~/.zshrc 是环境变量入口;改错文件(如误改 ~/.bash_profile)会导致配置不生效。
系统易学易懂,用户只需会上网、不需学习编程及任何语言,只要使用该系统平台,只要会打字,即可在线直接完成建站所有工作。本程序适合不懂php环境配置的新手用来在本机调试智能SiteSEO网站优化软件,安装过程极其简单。您的网站地址:http://localhost您的网站后台:登录地址: http://localhost/admin.php密 码: admin服务器套件所包含的软件:nginx-0.7
立即学习“go语言免费学习笔记(深入)”;
- 确认当前 shell:
echo $SHELL,输出应为/bin/zsh - 编辑配置:
code ~/.zshrc(或用nano),追加一行:export PATH="/opt/homebrew/bin:$PATH"
(Apple Silicon)或export PATH="/usr/local/bin:$PATH"
(Intel) - 重载配置:
source ~/.zshrc,再运行go version应显示类似go version go1.22.4 darwin/arm64 - ⚠️ 注意:不要设置
GOROOT—— Homebrew 安装的 Go 会自动推导,硬设反而导致go install失败
验证模块代理与基础开发能力
Go 1.18+ 默认启用 GO111MODULE=on,但国内直连 proxy.golang.org 常超时,必须显式配置代理,否则 go mod download 卡住。
- 检查模块状态:
go env GO111MODULE,应为on - 设置国内代理(推荐清华源):
go env -w GOPROXY=https://mirrors.tuna.tsinghua.edu.cn/goproxy/,direct - 快速测试:
mkdir hello && cd hello
输出
go mod init hello
echo 'package main\nimport "fmt"\nfunc main() { fmt.Println("ok") }' > main.go
go run main.gook即成功
真正容易被忽略的是:Homebrew 更新 Go 后(如 brew upgrade go),GOROOT 实际指向新路径,但旧项目若在 go.mod 中锁定了 go 1.20,运行时仍会报版本不匹配——此时不能删 GOROOT,而应让项目适配或用 go install golang.org/dl/go1.20@latest && go1.20 download 临时切换。









