/bin/zsh -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)"需要 Xcode Command Line Tools，脚本会检测并提示安装。
/bin/zsh -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)" -- --configure仅配置已有 Homebrew，备份并迁移旧镜像设置，不重新安装或升级软件。完成后重新打开终端和 BrewUI。
镜像配置写入哪里？
写入 $(brew --prefix)/etc/homebrew/brew.env，使用 NAME=value，不加 export。脚本会检查用户级与 XDG 配置中的覆盖设置。BrewUI 不读取 .zshrc；修改后重启应用，在 Configuration 中核对生效地址。
Homebrew 官方桌面版
macOS 26+先完成 Homebrew 安装与镜像配置，再安装 BrewUI：
brew install --cask homebrew-app桌面版和终端可共用下载设置；修改后重新打开应用，在「配置」页面确认。
卸载 Homebrew
将移除 Homebrew 及已安装的软件包。仅需换源时，请使用「配置镜像」；卸载脚本会要求确认后再执行。
/bin/zsh -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)" -- --uninstall/bin/bash -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)"需要 Git、curl 及构建依赖，脚本会检测并提示安装。
/bin/bash -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)" -- --configure仅配置已有 Homebrew，备份并迁移旧镜像设置，不重新安装或升级软件。完成后重新打开终端。
镜像配置写入哪里？
写入 $(brew --prefix)/etc/homebrew/brew.env，使用 NAME=value，不加 export。脚本会检查用户级与 XDG 配置中的覆盖设置。
BrewUI 当前仅支持 macOS 26+
Linux 可继续使用 Homebrew 命令行、镜像配置与 AI 排障。
卸载 Homebrew
将移除 Homebrew 及已安装的软件包。仅需换源时，请使用「配置镜像」；卸载脚本会要求确认后再执行。
/bin/bash -c "$(curl -fsSL https://brew-cn.mintimate.cn/install)" -- --uninstall项目数据
最近获取地区
按脚本请求计数，包含重复获取、配置及卸载请求，不代表成功安装人数。
加载中…
视频安装教程 macOS / Linux 安装全过程bilibili.com/video/BV1AEX9BsELi/
多镜像可选
中科大、阿里云、清华等镜像
跨平台兼容
macOS / Linux，自动识别架构
终端 / 桌面共享
镜像写入 brew.env，路径单独配置
配置自动备份
修改已有配置前保留备份
安装、配置与验证
- 01
运行对应命令
首次安装执行安装命令；已安装用户使用 --configure 配置镜像，无需重装。
- 02
选择镜像并应用配置
按提示选择镜像，配置写入 brew.env。完成后重新打开终端；BrewUI 用户退出后重新打开应用。
- 03
验证当前环境
brew --version需要进一步检查时运行
brew doctor；BrewUI 用户可在 Configuration 中核对镜像。
常见问题
安装后提示 brew: command not found？
先重新打开终端，或执行安装末尾输出的环境配置命令。如果仍找不到 brew，请将报错与系统信息交给 AI 排障。
已经安装了 Homebrew，能只更换镜像吗？
可以。使用上方配置命令的 --configure 模式，只调整现有 Homebrew 的镜像配置。脚本会备份并迁移旧镜像设置，PATH 配置单独保留；选择 4) 官方源 可恢复上游。
哪些系统可以使用 Homebrew 桌面版？
官方 BrewUI 需要 macOS 26+。其他受支持系统仍可使用 Homebrew 命令行；Linux 不提供 BrewUI。
终端已换源，BrewUI 为什么没有生效？
BrewUI 不读取 .zshrc 等 Shell 启动文件。使用 --configure 将镜像迁移到 $(brew --prefix)/etc/homebrew/brew.env，再退出并重启 BrewUI，在 Configuration 中核对。仍有差异时，检查用户级或 XDG 配置是否覆盖。
提示安装 Xcode Command Line Tools？
这是 macOS 的前置依赖。完成系统弹窗中的安装，再重新运行 Homebrew 安装命令。
镜像检测结果能代表本机下载速度吗？
不能。在线检测来自服务端节点，用于检查可达性和同步情况；你的运营商、地区和网络环境都会影响实际下载速度。
镜像与配置参考
镜像源
| 镜像 | 配置范围 | 参考文档 |
|---|---|---|
| USTC 中科大 | brew Git / Bottles / API | 镜像说明 |
| Aliyun 阿里云 | brew Git / Bottles / API | 镜像目录 |
| TUNA 清华 | brew Git / Bottles / API | 镜像说明 |
| 官方源 | 恢复 Homebrew 上游来源 | 官方文档 |
| Tencent 腾讯云 | 安装时输入 5 选择，使用完整克隆。 | |
镜像在安装或 --configure 配置过程中选择，不作为速度排名。在线检测来自云端节点；Cask 应用文件仍可能从软件厂商下载。
现代 Homebrew 默认通过 API 获取软件信息，无需预先克隆 core/cask；USTC 的 core/cask Git 镜像已停用。
/opt/homebrew/usr/local/home/linuxbrew/.linuxbrew配置详情与官方资源
- $(brew --prefix)/etc/homebrew/brew.env
- 终端与 BrewUI 共享的镜像配置，使用 NAME=value 格式，不加 export。PATH 与 brew shellenv 仍由 Shell 配置负责。
- HOMEBREW_BREW_GIT_REMOTE
- Homebrew 主程序 Git 仓库
- HOMEBREW_BOTTLE_DOMAIN
- 预编译软件包下载地址，不代表所有 Cask 应用下载源
- HOMEBREW_API_DOMAIN
- 软件元数据 API 地址
BrewUI 不读取 Shell 启动文件，也不继承 XDG_CONFIG_HOME。修改后重启应用并检查 Configuration；如有差异，核对 ~/.homebrew/brew.env 与终端的 XDG 配置。