开源 · 免费 · 极速

🍺 Homebrew CN 镜像安装

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

🚀 一键安装

复制以下命令到终端运行，跟随引导即可完成安装：

$ /bin/zsh -c "$(curl -fsSL https://brew-cn.mintimate.cn/api/install)"

💡 支持 macOS (Intel & Apple Silicon) 及 Linux · 脚本运行后可选择镜像源

📊 实时统计

- 累计安装次数

- 最近一次安装

了解更多

✨ 功能特性

🪞 镜像源可选支持中科大 USTC、阿里云 Aliyun、清华 TUNA、官方源四选一

🖥️ macOS 全架构兼容 Intel (x86_64) 和 Apple Silicon (M1/M2/M3/M4)

🐚 多 Shell 支持自动适配 Zsh（默认）/ Bash，写入对应配置文件

🔍 智能检测自动检测系统架构、前置依赖（git、curl 等）

🔄 已安装适配已有 Homebrew 时可仅重新配置镜像源

💾 自动备份修改 Shell 配置文件前自动创建备份，安全无忧

📋 安装流程

复制命令到终端执行

脚本会自动检查系统环境，提示选择镜像源（中科大 / 阿里云 / 清华 / 官方源），默认推荐中科大。

等待自动安装完成

脚本自动下载 Homebrew、配置镜像源和环境变量，安装过程约 1-3 分钟（取决于网速）。

使配置生效

安装完成后，执行 source ~/.zshrc 或重新打开终端窗口。

验证安装

运行 brew --version 和 brew doctor 确认一切正常。

🪞 镜像源

镜像源	特点
USTC	推荐同步快，稳定
阿里云	极速 CDN 加持
清华 TUNA	教育网老牌镜像

脚本运行时交互选择，默认使用中科大源。

📍 安装路径

Apple Silicon /opt/homebrew M1 / M2 / M3 / M4

Intel /usr/local x86_64 架构

⚙️ 自动配置的环境变量

脚本会自动在 Shell 配置文件中写入以下变量（无需手动操作）：

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

🗑️ 一键卸载

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

$ /bin/zsh -c "$(curl -fsSL https://brew-cn.mintimate.cn/api/install)" -- --uninstall

⚠️ 脚本会列出已安装的软件包数量，需输入 yes 确认后才开始卸载

❓ 常见问题

安装后执行 brew 提示 "command not found"

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

brew update 时报 Git 相关错误

尝试执行 brew update-reset 重置 Homebrew 仓库状态。

想更换镜像源怎么办？

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

macOS 提示需要安装 Xcode Command Line Tools

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

如何切换回官方源？

编辑 ~/.zshrc 删除 Homebrew 镜像配置相关行，然后运行 git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew 和 brew update-reset 即可。

🔗 参考链接

🌐 Homebrew 官网 brew.sh 📖 官方安装文档 docs.brew.sh 🏫 清华 TUNA 镜像帮助 mirrors.tuna.tsinghua.edu.cn 🔬 中科大 USTC 镜像帮助 mirrors.ustc.edu.cn