必须先安装Xcode命令行工具（执行xcode-select --install并验证路径），再运行国内镜像一键脚本/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"，选择清华或中科大源，输入密码后按提示执行eval命令并验证brew --version和brew doctor。

直接在终端里运行一条命令就能装好 homebrew，但必须先装好 xcode 命令行工具，否则会失败。

先装好 Xcode 命令行工具

这是硬性前提，Homebrew 依赖里面的编译器和系统头文件：

• 打开终端，输入 xcode-select --install，弹窗点“安装”，等进度条走完
• 装完后运行 xcode-select -p，看到输出 /Library/Developer/CommandLineTools 就说明到位了
• 如果提示路径错误，补一句 sudo xcode-select --reset 重置一下

推荐国内镜像一键安装（新手首选）

官方脚本直连 GitHub 容易超时或中断，用清华或中科大镜像更稳，还带中文菜单：

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

• 在终端粘贴执行：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
• 出现选项后，输入 2（清华源）或 1（中科大源），回车确认
• 输入管理员密码（输的时候不显示字符，输完直接回车）
• 安装完成后，终端会提示类似 eval "$(/opt/homebrew/bin/brew shellenv)" 的命令，复制执行一次

验证是否真正可用

装完不代表能用，得确认环境变量生效、路径正确：

• 运行 brew --version，能看到版本号（比如 4.3.5）说明基础就绪
• 再运行 brew doctor，输出 Your system is ready to brew. 才算真正成功
• 如果提示 PATH 问题，按提示把 eval 命令加进 ~/.zshrc（Apple Silicon）或 ~/.zshrc（Intel），再执行 source ~/.zshrc

其他可选方式

如果你网络通畅、偏好官方源，也可以用原始脚本：

• 终端运行：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
• 过程中会提示输入密码，装完按提示执行初始化命令并 source 配置文件即可
• macOS 14 及以上还支持双击 homebrew.pkg 离线安装包，适合不熟悉命令行的用户