用 homebrew 在 macos 上安装 go 需四步：先确认并更新 homebrew，再安装指定版本 go（如 go@1.26），接着正确配置 gopath 和 path（zsh 用户改 ~/.zshrc，含 /opt/homebrew/bin 和 $gopath/bin），最后设置 goproxy 代理并用 go mod init 和 go run 验证全流程。

用 homebrew 在 macos 上装 go 很快，但容易卡在环境变量没生效或路径配错这一步。只要按顺序做对四件事：装好 homebrew、装 go、设对 path 和 gopath、加国内代理，基本就通了。

确认并更新 Homebrew

先检查 Homebrew 是否已安装且可用：

• 终端运行 which brew —— 有输出说明已装；没输出就执行安装命令
• 已有 Homebrew 的话，务必运行 brew update && brew doctor，修复可能的权限或源问题（尤其在国内网络下，常因 homebrew-core 源未同步导致 brew install go 找不到包）
• 若出现权限错误，补一句：sudo chown -R $(whoami) $(brew --prefix)/*

安装 Go 并确认路径

Homebrew 安装的是版本化 Go（如 go@1.26），不是最新版：

macOS Notes

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

下载

• 运行 brew install go@1.26（推荐指定版本，避免自动升级到不兼容的新版）
• 安装后，Go 可执行文件实际在：
  • Apple Silicon（M1/M2/M3）：/opt/homebrew/bin/go
  • Intel 芯片：/usr/local/bin/go
• 验证是否可调用：go version —— 应输出类似 go version go1.26.4 darwin/arm64
• 如果提示 command not found: go，说明上面那个 bin 目录还没进 PATH，下一步必须处理

配置环境变量（关键！）

macOS Catalina 及之后默认用 zsh，所以改 ~/.zshrc；老系统用 bash 就改 ~/.bash_profile：

• 运行 echo $SHELL 确认当前 shell 类型
• 编辑配置文件：nano ~/.zshrc
• 在文件末尾添加三行（Apple Silicon 示例）：

export GOPATH=$HOME/go
export PATH="$PATH:$GOPATH/bin"
export PATH="/opt/homebrew/bin:$PATH"

• 保存退出（Ctrl+O → Enter → Ctrl+X），然后立即生效：source ~/.zshrc
• 验证：go env GOPATH 应返回 /Users/你的用户名/go；echo $PATH 应包含 /opt/homebrew/bin 和 $HOME/go/bin

设置模块代理与简单验证

不配代理，go mod download 或 go get 很可能失败：

• 运行：go env -w GOPROXY=https://goproxy.cn,direct
• 新建测试项目验证全流程：
  mkdir ~/hello && cd ~/hello
  go mod init hello
  echo 'package main; import "fmt"; func main() { fmt.Println("Hello, Go!") }' > main.go
  go run main.go
• 成功输出 Hello, Go! 即表示编译、模块、执行全链路正常