在MacOS系统中开发Golang项目时，Homebrew是最常用的包管理工具，能够帮助我们快速安装、更新和管理Golang相关的依赖。通过Homebrew安装Golang依赖可以避免手动配置复杂的编译环境，大幅降低安装出错的概率。
前置条件检查
首先确认你的MacOS系统已经安装了Homebrew，打开终端执行以下命令检查版本：
# 检查Homebrew是否安装 brew --version
如果终端返回了Homebrew的版本号，说明已经安装成功。如果没有安装，可以先执行官方安装命令完成Homebrew的安装：
# 安装Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
通过Homebrew安装Golang
确认Homebrew可用后，就可以直接安装Golang了，执行以下命令：
# 更新Homebrew仓库 brew update # 安装Golang brew install go
如果需要安装指定版本的Golang，可以先查看Homebrew支持的版本列表：
# 查看可用的Golang版本 brew search go
找到需要的版本后，通过以下命令安装指定版本：
# 安装指定版本的Golang，例如1.21版本 brew install go@1.21
配置Golang环境变量
安装完成后，需要配置Golang的环境变量，让系统能够识别go命令。打开你的终端配置文件，如果你使用的是zsh，编辑~/.zshrc，如果使用bash则编辑~/.bash_profile：
# 编辑zsh配置文件 vim ~/.zshrc
在文件末尾添加以下内容，注意如果你的Golang是通过brew安装的，默认路径一般是/usr/local/opt/go/libexec，如果是安装的指定版本，路径可能是/usr/local/opt/go@1.21/libexec：
# 配置GOROOT export GOROOT=/usr/local/opt/go/libexec # 配置GOPATH，自定义你的工作目录 export GOPATH=$HOME/go # 将Golang的bin目录加入系统PATH export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
保存文件后，执行以下命令让配置生效：
# 让配置生效 source ~/.zshrc
验证安装结果
配置完成后，执行以下命令验证Golang是否安装成功：
# 查看Golang版本 go version # 查看Golang环境配置 go env
如果终端返回了正确的Golang版本号，并且go env输出的GOROOT和GOPATH和你的配置一致，说明安装成功。
常见安装问题解决
权限不足问题
如果安装时出现权限错误，可以执行以下命令修复Homebrew的权限：
# 修复Homebrew权限 sudo chown -R $(whoami) /usr/local/var/homebrew sudo chown -R $(whoami) /usr/local/opt
版本切换问题
如果需要切换不同版本的Golang，可以通过Homebrew的链接命令实现：
# 取消当前版本的链接 brew unlink go # 链接指定版本 brew link go@1.21
依赖下载慢问题
国内用户可能会遇到Golang依赖下载慢的问题，可以配置GOPROXY代理：
# 配置GOPROXY go env -w GOPROXY=https://goproxy.cn,direct
GolangHomebrewMacOSgo_install修改时间：2026-07-24 00:51:22