homebrew 安装需先配置 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 命令生效。
四、手动克隆仓库安装（自定义路径需求）
适用于需指定非默认安装目录（如用户主目录下）、规避系统级权限限制、或需离线部署的高级使用场景；该方式绕过官方脚本，直接操作 Git 仓库与初始化逻辑。
1、确保已安装 Git，并确认终端中可执行 git --version。
2、创建目标安装目录，例如：mkdir -p $HOME/.local/homebrew。
3、克隆 Homebrew 核心仓库：git clone https://github.com/Homebrew/brew $HOME/.local/homebrew。
4、将 bin 目录加入 PATH：向 ~/.zshrc 追加一行 export PATH="$HOME/.local/homebrew/bin:$PATH"。
5、执行 source ~/.zshrc 生效，并运行 brew update 完成初始化。
五、验证安装结果
安装完成后需确认 Homebrew 可正常调用且环境无冲突，避免后续使用中出现命令未识别或依赖检查失败等问题。
1、在终端中输入 brew --version，应输出类似 Homebrew 4.3.0 的版本号。
2、运行 brew doctor，若输出中无红色警告文字，仅含提示性建议，则表示基础环境就绪。
3、尝试执行 brew search wget，能列出匹配项即说明索引与远程仓库通信正常。
