Homebrew 是 macOS 必备包管理器，安装前需先配置 Xcode 命令行工具；官方脚本、国内镜像（如清华源）、手动克隆三种方式适配不同网络与权限场景；最后须验证 brew --version、brew doctor 和 brew search。

如果您在 macOS 系统中需要快速安装开发依赖、命令行工具或图形界面应用，但尚未配置包管理环境，则很可能是由于 Homebrew 尚未安装。以下是多种可靠且适配不同网络与系统环境的安装方法：

一、验证并安装 Xcode 命令行工具

Xcode 命令行工具提供编译器、头文件及系统构建依赖，是 Homebrew 正常运行的前置必要条件；缺失将导致 brew install 失败或软件包编译中断。

1、打开终端（可通过 Spotlight 搜索 Terminal 启动）。

2、执行 xcode-select --install 并按提示完成安装流程。

3、安装完毕后，运行 xcode-select -p 验证路径是否输出 /Library/Developer/CommandLineTools。

4、若路径异常或返回错误，执行 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 出现超时、连接拒绝或下载缓慢时，清华、中科大等高校镜像源可显著提升安装成功率，并内置中文交互与多源切换逻辑。

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 $HOME/homebrew。

2、进入该目录：cd $HOME/homebrew。

3、克隆 brew 主仓库（使用中科大镜像加速）：git clone https://mirrors.ustc.edu.cn/brew.git .。

4、将 bin 目录加入 PATH：echo 'export PATH="$HOME/homebrew/bin:$PATH"' >> ~/.zshrc。

5、加载新配置：source ~/.zshrc。

6、执行 brew update 初始化本地仓库索引。

五、验证 Homebrew 安装状态

该步骤用于确认 brew 命令已正确识别、核心功能可调用，避免因环境变量未生效或权限问题导致后续操作失败。

1、执行 brew --version，应输出类似 Homebrew 4.3.0 的版本号。

2、执行 brew doctor，若输出 Your system is ready to brew. 即表示环境健康。

3、执行 brew search wget，应返回包含 wget 的匹配结果列表，证明公式库已同步可用。