使用镜像源快速安装 Homebrew 的一键脚本，内置清华 TUNA / 中科大 USTC 镜像源，告别龟速下载。

• 🪞 镜像源可选 — 支持中科大 USTC、阿里云 Aliyun、清华 TUNA、官方源四选一
• 🖥️ macOS 全架构 — 兼容 Intel (x86_64) 和 Apple Silicon (M1/M2/M3/M4)
• 🐚 多 Shell 支持 — 自动适配 Zsh（默认）/ Bash，写入对应配置文件
• 🔍 智能检测 — 自动检测系统架构、前置依赖（git、curl 等）
• 🔄 已安装适配 — 已有 Homebrew 时可仅重新配置镜像源
• 🗑️ 一键卸载 — 内置完整卸载功能，自动清理软件包、目录和环境变量
• 💾 自动备份 — 修改 Shell 配置文件前自动创建备份

/bin/zsh -c "$(curl -fsSL https://cnb.cool/Mintimate/tool-forge/homebrew-cn/-/git/raw/main/install.sh)"

如果无法访问 GitHub，也可以先将脚本下载到本地后运行：

curl -fsSL -o install.sh https://cnb.cool/Mintimate/tool-forge/homebrew-cn/-/git/raw/main/install.sh
/bin/zsh install.sh

git clone https://cnb.cool/Mintimate/tool-forge/homebrew-cn
cd homebrew-cn
/bin/zsh install.sh

脚本内置了完整的卸载功能，会自动卸载所有已安装的软件包、清理安装目录及缓存、移除 Shell 配置文件中的 Homebrew 环境变量，并在操作前自动备份配置文件。

在线执行：

/bin/zsh -c "$(curl -fsSL https://cnb.cool/Mintimate/tool-forge/homebrew-cn/-/git/raw/main/install.sh)" -- --uninstall

本地执行：

/bin/zsh install.sh --uninstall

脚本会列出当前已安装的软件包数量，需输入 yes 确认后才开始卸载，不会误操作。

运行脚本后，按提示操作即可：

======================================
   Homebrew 镜像源一键安装脚本
   作者: Mintimate
   博客: https://www.mintimate.cn
   GitHub: https://github.com/Mintimate
======================================

请选择镜像源:
  1) 中国科学技术大学 USTC  (https://mirrors.ustc.edu.cn)
  2) 阿里云 Aliyun  (https://mirrors.aliyun.com/homebrew/)
  3) 清华大学 TUNA  (https://mirrors.tuna.tsinghua.edu.cn)
  4) 官方源 (不使用镜像，需要良好的网络环境)

请输入选项 [1/2/3/4] (默认: 1):

安装过程中，脚本会自动配置环境变量并下载 Homebrew：

安装完成后，执行以下命令使配置生效：

source ~/.zshrc

验证安装：

brew --version
brew doctor

镜像源	Git 仓库	二进制瓶 (Bottles)	API
USTC	mirrors.ustc.edu.cn/brew.git	mirrors.ustc.edu.cn/homebrew-bottles	mirrors.ustc.edu.cn/homebrew-bottles/api
阿里云	mirrors.aliyun.com/homebrew/brew.git	mirrors.aliyun.com/homebrew/homebrew-bottles	mirrors.aliyun.com/homebrew/homebrew-bottles/api
清华 TUNA	mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git	mirrors.tuna.tsinghua.edu.cn/homebrew-bottles	mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api

脚本会自动配置以下环境变量：

export HOMEBREW_BREW_GIT_REMOTE="..."       # brew 主仓库
export HOMEBREW_CORE_GIT_REMOTE="..."       # homebrew-core 仓库
export HOMEBREW_BOTTLE_DOMAIN="..."         # 预编译二进制包下载地址
export HOMEBREW_API_DOMAIN="..."            # API 地址
export HOMEBREW_CASK_GIT_REMOTE="..."       # homebrew-cask 仓库

架构	安装路径
Apple Silicon (M1/M2/M3/M4)	/opt/homebrew
Intel (x86_64)	/usr/local

如果之后网络环境改善，想切换回官方源：

1. 编辑 ~/.zshrc，删除 # Homebrew 镜像配置 相关行
2. 运行以下命令：

git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
brew update-reset

A: 请先执行 source ~/.zshrc 使环境变量生效，或重新打开终端。

A: 尝试执行：

brew update-reset

A: 重新运行安装脚本，选择新的镜像源即可。脚本会自动清理旧配置并写入新配置。

A: 脚本会自动触发安装，请在弹出的对话框中点击"安装"，安装完成后重新运行脚本。

A: 使用脚本自带的卸载功能（推荐）：

/bin/zsh -c "$(curl -fsSL https://cnb.cool/Mintimate/tool-forge/homebrew-cn/-/git/raw/main/install.sh)" -- --uninstall

也可以使用官方卸载脚本：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)"

如果脚本都无法运行，可以手动删除并移除环境变量内相关配置：

# Apple Silicon
sudo rm -rf /opt/homebrew

# Intel (x86_64)
sudo rm -rf /usr/local/Homebrew
sudo rm -rf /usr/local/Caskroom
sudo rm -rf /usr/local/Cellar
sudo rm -rf /usr/local/bin/brew

# 通用缓存清理
rm -rf ~/Library/Caches/Homebrew
rm -rf ~/Library/Logs/Homebrew

• Homebrew 官方安装文档
• 清华 TUNA Homebrew 镜像帮助
• 中科大 USTC Homebrew 镜像帮助
• Homebrew 官网

MIT License