Homebrew 是 macOS 推荐的包管理器,需先安装 Xcode 命令行工具,再通过官方脚本、国内镜像或手动克隆方式安装,最后用 brew install 和 brew install --cask 分别管理 CLI 工具与 GUI 应用。

如果您尝试在 macOS 系统中部署开发工具,但发现缺乏统一、可靠的软件安装与依赖管理机制,则很可能是尚未配置 Homebrew 包管理器。以下是完成 Homebrew 安装及使用 brew 命令安装、管理开发工具的完整操作流程:
一、验证并安装 Xcode 命令行工具
Homebrew 依赖 Xcode 命令行工具提供的编译环境与系统头文件,未安装将导致后续命令执行失败或部分软件包无法构建。
1、打开终端,执行 xcode-select --install 并按提示完成安装。
2、安装完成后,运行 xcode-select -p 验证路径输出是否为 /Library/Developer/CommandLineTools。
3、若已安装但路径异常,可重置为默认路径:sudo xcode-select --reset。
二、通过官方脚本安装 Homebrew
该方式由 Homebrew 官方维护,自动适配 Apple Silicon(M1/M2/M3)与 Intel 架构,并将 brew 安装至标准路径(/opt/homebrew 或 /usr/local),是首选安装方法。
1、在终端中粘贴并执行官方安装命令:/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
2、按回车确认安装路径(默认为 /opt/homebrew),输入当前用户管理员密码(输入时无可见字符,属正常现象)。
3、安装完成后,终端显示 Installation successful!,并提示执行 shell 初始化命令。
4、根据提示运行初始化命令(如 echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc),随后执行 source ~/.zshrc 加载配置。
三、使用国内镜像源一键安装(网络受限场景)
当 raw.githubusercontent.com 访问不稳定或超时,可改用由清华、中科大等高校维护的 Gitee 托管脚本,内置中文交互与多源切换能力,显著提升成功率。
1、在终端中执行:/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
2、出现菜单后,输入数字 2 选择清华大学镜像源(推荐,响应快且稳定)。
3、按提示输入管理员密码,随后在选项列表中输入 5 执行全自动安装与环境变量写入。
4、安装结束时,终端提示是否执行 source ~/.zprofile,请立即执行以使 brew 命令生效。
四、手动克隆仓库安装(自定义路径需求)
适用于需指定非默认安装目录(如用户主目录下)、规避系统级权限限制,或需离线部署的高级场景。
1、创建目标安装目录:mkdir -p ~/homebrew && cd ~/homebrew。
2、克隆 Homebrew 主仓库:git clone https://github.com/Homebrew/brew.git。
3、将 bin 路径加入 shell 配置:echo 'export HOMEBREW_PREFIX="$HOME/homebrew/brew"' >> ~/.zshrc,再添加:echo 'export PATH="$HOMEBREW_PREFIX/bin:$PATH"' >> ~/.zshrc。
4、重新加载配置:source ~/.zshrc,然后验证:brew --version 应返回版本号。
五、使用 brew 安装与管理开发工具
Homebrew 提供两类安装模式:brew install 用于命令行工具(CLI),brew install --cask 用于图形界面应用(GUI),二者均自动处理依赖与路径注册。
1、安装常用 CLI 工具:brew install wget git node python。
2、安装 GUI 应用:brew install --cask visualstudiocode google-chrome firefox。
3、更新所有已安装项:brew update && brew upgrade;仅升级特定工具:brew upgrade node。
4、查看已安装软件列表:brew list(CLI)或 brew list --cask(GUI)。
5、卸载软件:brew uninstall wget 或 brew uninstall --cask visualstudiocode。











