homebrew是macos开发者必备包管理器，需先安装xcode命令行工具，再通过官方脚本、国内镜像或cdn加速方式安装，适配apple silicon与intel芯片，并配置对应环境变量，最后用brew --version和brew doctor验证成功。
如果你在 macOS 系统上需要一键安装、更新或卸载命令行工具（比如 Git、Node.js、Python、ffmpeg 等），但每次都要手动下载编译或找官网 DMG 包，说明你还没装 Homebrew——这个被 8000 万 macOS 开发者默认预装的包管理器，它能让所有软件安装变成一条命令的事。
确认并安装 Xcode 命令行工具
Homebrew 依赖编译环境，必须先装 Xcode 命令行工具，否则后续所有安装都会卡在「clang: command not found」错误上。
打开终端，输入：xcode-select --install → 回车 → 弹出窗口点“安装” → 等进度条走完（通常 2–5 分钟）。
验证是否装好：执行 xcode-select -p，如果输出 /Library/Developer/CommandLineTools 或类似路径，说明已就位。如果报错 “command line tools are already installed”，可跳过这步。
选择一种安装方式执行
根据你的网络状况和芯片类型（Intel / Apple Silicon），选下面其中一种方法即可，不要叠加执行。
方法一：官方脚本（适合能直连 GitHub 的网络）
在终端中复制粘贴并回车：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
按提示回车继续 → 输入开机密码（输的时候不显示字符，输完直接回车）→ 等待自动完成。
【关键提醒】Apple Silicon（M1/M2/M3）机型安装后默认路径是 /opt/homebrew，Intel 是 /usr/local；后续配置环境变量时路径不能写错。
方法二：国内镜像一键安装（推荐绝大多数用户）
中科大镜像响应快、稳定性高，适配新老系统：
终端执行：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
脚本启动后，看到选项列表 → 输入 1 → 回车 → 输入开机密码 → 等待自动部署完成。
安装结束时，终端会显示类似 ==> 成功!请运行以下命令以生效: eval "$(/opt/homebrew/bin/brew shellenv)" → 立即复制这行命令并回车执行一次，让当前终端立刻识别 brew。
方法三：CDN 加速安装（临时应急用）
当 Gitee 也打不开时，用 jsDelivr CDN 加载逻辑：
/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"
这条命令绕过原始域名，对 DNS 污染或区域限流更友好，但不保证长期可用，仅作备用。
验证安装是否成功
执行 brew --version → 应输出类似 Homebrew 4.3.2 的版本号。
再执行 brew doctor → 输出 Your system is ready to brew. 即表示环境完全就绪。
如果提示 zsh: command not found: brew，说明环境变量没生效：检查你用的是 zsh（macOS Catalina 及以后默认）还是 bash，然后把对应语句加进 ~/.zprofile（zsh）或 ~/.bash_profile（bash）里，再执行 source ~/.zprofile。
