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。


















