Homebrew 安装与国内镜像配置全攻略

Homebrew 是 macOS 上最流行的包管理工具，能够让你像在 Linux 下一样方便地安装、升级、卸载各种开发工具和软件包。它极大地简化了软件环境的管理，是开发者必备利器。

一、Homebrew 的作用简介

  • 一键安装/卸载常用开发工具（如 git、node、python 等）
  • 自动管理依赖，保持系统整洁
  • 支持快速升级和回滚
  • 拥有丰富的第三方软件源（Tap）

二、Homebrew 安装步骤

方法一：官方安装脚本

  1. 打开终端（Terminal）。
  2. 执行以下命令（推荐使用官方脚本）：
    1
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  3. 安装过程中如遇到权限提示，按提示输入密码。
  4. 安装完成后，按终端提示将 brew 路径加入环境变量（如 zsh 用户可在 ~/.zshrc 中添加）：
    1
    2
    echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
    source ~/.zshrc
  5. 验证安装：
    1
    brew --version
    若能正确显示版本号，说明安装成功。

方法二：一键国内安装脚本（推荐中国大陆用户）

  1. 打开终端，执行以下命令：
    1
    /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
  2. 按照脚本提示操作，自动完成 Homebrew 安装及国内镜像配置。

三、配置 Homebrew 国内镜像（加速下载，推荐中国大陆用户）

由于网络原因，国内用户使用 Homebrew 时经常遇到下载缓慢甚至失败的问题。可通过配置清华大学等国内镜像源大幅提升速度。

1. 替换 Homebrew 主仓库源

1
2
cd "$(brew --repo)"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

2. 替换 Homebrew Core 源

1
2
cd "$(brew --repo homebrew/core)"
git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

3. 替换 Homebrew Bottles（二进制包）源

1
2
3
4
5
# 临时生效（当前终端会话）
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
# 永久生效（写入配置文件）
echo 'export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles' >> ~/.zshrc
source ~/.zshrc

4. 更新 Homebrew

1
brew update

5. 恢复官方源（如需）

如需恢复为官方源，可执行：

1
2
3
4
5
cd "$(brew --repo)"
git remote set-url origin https://github.com/Homebrew/brew.git
cd "$(brew --repo homebrew/core)"
git remote set-url origin https://github.com/Homebrew/homebrew-core.git
unset HOMEBREW_BOTTLE_DOMAIN

如遇问题可参考 清华大学开源镜像站 Homebrew 帮助文档 或在评论区留言。