homebrew 是 macos 最常用命令行包管理器，需先装 xcode 命令行工具，再运行官方脚本安装；推荐配置中科大或清华国内镜像源以加速，并通过 brew doctor、brew update、brew --version 等命令验证环境。
如果您在 macOS 系统上需要便捷地安装、管理和更新命令行工具与开源软件，则 Homebrew 是最常用且可靠的包管理器。以下是完成 Homebrew 安装及国内源配置的完整操作步骤：
一、安装 Homebrew
Homebrew 依赖 macOS 自带的 Xcode 命令行工具，需先确保其已安装；随后通过 Ruby 脚本执行一键安装流程。
1、打开“终端”应用（可通过 Spotlight 搜索 Terminal 打开）。
2、在终端中输入以下命令并回车，安装 Xcode 命令行工具：
xcode-select --install
3、当弹出窗口提示时，点击“安装”，等待进度完成并点击“完成”。
4、确认命令行工具已就绪：运行 xcode-select -p，输出应为 /Library/Developer/CommandLineTools 或类似路径。
5、执行官方安装脚本（需联网）：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
6、安装过程中提示按回车继续，若出现权限提示，请输入当前用户密码（输入时不显示字符，输完直接回车）。
7、安装完成后，运行 brew doctor 检查环境是否正常，输出中无红色警告即表示基础安装成功。
二、配置国内镜像源（中科大源）
由于 GitHub 原始源在国内访问缓慢，替换为中科大镜像可显著提升 brew update 和 brew install 的速度。
1、替换 brew.git 主仓库地址：
git -C $(brew --repo) remote set-url origin https://mirrors.ustc.edu.cn/brew.git
2、替换 homebrew-core.git 核心公式仓库地址：
git -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
3、替换 homebrew-cask.git 图形界面应用仓库地址（如需安装 Mac App）：
git -C $(brew --repo homebrew/cask) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
4、替换 homebrew-cask-versions.git 版本分支仓库地址：
git -C $(brew --repo homebrew/cask-versions) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask-versions.git
5、替换 homebrew-cask-fonts.git 字体仓库地址（如需安装字体）：
git -C $(brew --repo homebrew/cask-fonts) remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask-fonts.git
6、执行 brew update 刷新所有仓库索引，首次替换后可能耗时稍长，请耐心等待完成。
三、配置国内镜像源（清华源）
清华源是另一稳定高速的替代选项，适用于中科大源不可用或响应异常时的备用方案。
1、重置 brew.git 地址为清华镜像：
git -C $(brew --repo) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
2、重置 homebrew-core.git 地址：
git -C $(brew --repo homebrew/core) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
3、重置 homebrew-cask.git 地址：
git -C $(brew --repo homebrew/cask) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git
4、重置 homebrew-cask-versions.git 地址：
git -C $(brew --repo homebrew/cask-versions) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask-versions.git
5、重置 homebrew-cask-fonts.git 地址：
git -C $(brew --repo homebrew/cask-fonts) remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask-fonts.git
6、再次运行 brew update 验证源切换是否生效，观察输出中远程地址是否已指向 tuna.tsinghua.edu.cn。
四、验证安装与源配置状态
通过多维度命令检测 Homebrew 是否可用、源是否生效，避免后续使用中出现拉取失败或版本滞后问题。
1、检查 brew 版本信息：
brew --version
2、查看当前 brew 主仓库远程地址：
git -C $(brew --repo) config --get remote.origin.url
3、查看 homebrew-core 当前远程地址：
git -C $(brew --repo homebrew/core) config --get remote.origin.url
4、运行 brew search wget 测试公式搜索功能是否响应正常。
5、运行 brew info curl 查看已有公式详情，确认元数据加载无误。
6、尝试安装一个轻量工具验证全流程：
brew install htop
