homebrew 是 macos 高效管理开发工具的包管理器，官方脚本、国内镜像（如中科大）和 cdn 加速三种安装方式均经实测有效，需先装 xcode 命令行工具并配置环境变量。
如果您在macOS 系统上需要高效管理开发工具和命令行软件，但发现无法通过一条命令快速安装、更新或卸载程序，则很可能是尚未安装 Homebrew 包管理器。以下是多种可靠、实测有效的安装方法：
一、使用官方脚本安装（需网络通畅）
该方式直接调用 Homebrew 官方维护的安装脚本，适用于能稳定访问 GitHub 原始资源的网络环境。脚本会自动检测系统架构（Intel 或 Apple Silicon），并完成完整部署。
1、打开“终端”应用（可通过 Spotlight 搜索 Terminal 打开）。
2、执行 Xcode 命令行工具安装命令：xcode-select --install，弹出窗口中点击“安装”，等待完成。
3、验证工具路径是否正确：xcode-select -p，输出应为 /Library/Developer/CommandLineTools 或类似路径。
4、运行官方安装脚本：/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"。
5、按提示回车继续；当要求输入密码时，键入当前用户开机密码（输入过程不显示字符，输完直接回车）。
6、安装完成后，运行 brew doctor 检查环境，若输出 Your system is ready to brew. 即表示成功。
二、使用国内镜像脚本安装（推荐多数用户）
该方式绕过 GitHub 原始域名访问限制，采用国内高校或云服务商提供的镜像源，显著提升下载速度与成功率，尤其适合未配置代理的普通网络环境。
1、在终端中粘贴并执行中科大镜像安装命令：/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"。
2、脚本启动后，将列出多个镜像源选项（如清华、阿里、中科大、腾讯等），输入 1 并回车选择中国科学技术大学源（响应快且稳定）。
3、根据提示输入开机密码（同前，不显示字符）。
4、脚本自动完成 Homebrew 下载、安装及环境变量配置；安装结束时，终端将提示类似内容：==> 成功！请运行以下命令以生效： eval "$(/opt/homebrew/bin/brew shellenv)"。
5、立即复制该 eval 命令并在终端中执行一次，使环境变量即时生效。
6、执行 brew doctor 验证，确认输出 Your system is ready to brew.。
三、使用 CDN 加速脚本安装（备用方案）
当 Gitee 访问受限或镜像脚本响应异常时，此方式通过 jsDelivr 全球 CDN 加载安装逻辑，兼容性高且无需额外依赖，适合临时应急场景。
1、在终端中执行 CDN 加速安装命令：/bin/bash -c "$(curl -fsSL https://cdn.jsdelivr.net/gh/Homebrew/install@HEAD/install.sh)"。
2、若提示 command not found: curl，说明未安装 curl 工具，请先运行 xcode-select --install 完成基础工具链部署。
3、脚本运行过程中会自动创建 /opt/homebrew（Apple Silicon）或 /usr/local/Homebrew（Intel）目录，并设置对应权限。
4、安装完成后，对 Apple Silicon Mac 执行：echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc；对 Intel Mac 执行：echo 'eval "$(/usr/local/Homebrew/bin/brew shellenv)"' >> ~/.zshrc && source ~/.zshrc。
5、执行 brew --version，确认返回有效版本号（如 4.3.10）。
