国内环境下Homebrew的保姆级安装指南

Homebrew，作为macOS上最流行的包管理器，是开发者工具箱中必不可少的工具。然而，由于国内特殊的网络环境，很多用户在安装时都会遇到下载缓慢、连接失败等问题。本文将详细介绍两种在国内成功安装Homebrew的方法，让你轻松拥有这个强大的包管理器。

方法一：国内镜像一键安装（最推荐）

这是最省心、成功率最高的方法。社区维护的一键安装脚本会自动帮你配置好国内镜像源，整个过程只需要几分钟。

安装步骤

1. 打开终端（Terminal）

2. 复制并运行安装命令：

   /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
   

3. 根据提示操作：

   • 当脚本显示镜像源选择菜单时，输入 1 选择清华大学源（或其他你喜欢的镜像源）
   • 提示输入密码时，直接输入你的macOS开机密码（输入时不会显示字符，这是正常的）
   • 遇到 “Press RETURN/ENTER…” 提示时，直接按回车键继续

4. 配置环境变量：
   脚本运行完毕后，终端可能会显示一行以 eval 开头的命令，例如：

   eval "$(/opt/homebrew/bin/brew shellenv)"
   

   务必复制并运行这行命令，否则 brew 命令无法使用。

5. 重启终端并验证：
   退出并重新打开终端，运行：

   brew -v
   

   如果显示版本号，说明安装成功。

方法二：官方脚本 + 手动换源

如果你想更深入地了解Homebrew的配置过程，或者对官方脚本有特别的偏好，也可以采用这种方法。

安装步骤

1. 安装Xcode命令行工具（这是Homebrew的依赖）：

   xcode-select --install
   

   如果提示已经安装，可以跳过此步。

2. 运行官方安装脚本：

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

   ⚠️ 注意：这一步可能会很慢或失败，需要耐心多次尝试。

3. 手动配置国内镜像源：
   安装完成后，将默认源替换为中科大源（你也可以选择其他镜像源）：

   # 更换 Homebrew 核心代码仓库
   git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git
   
   # 更换核心软件包仓库
   git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git
   
   # 更换 Cask 仓库（用于安装GUI应用）
   git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git
   

4. 配置二进制包下载源：
   编辑你的shell配置文件（~/.zshrc 或 ~/.bash_profile），在末尾添加：

   export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"
   

   保存后运行 source ~/.zshrc 使配置生效。

安装后检查

无论用哪种方法安装，都建议运行以下命令检查Homebrew的状态：

brew doctor

如果看到 Your system is ready to brew. 的提示，就说明一切正常，可以开始使用了。

常用命令速览

为了方便你快速上手，这里列出一些最常用的Homebrew命令：

结语

安装好Homebrew后，你就可以像在Linux上使用apt-get一样，轻松地安装、更新和管理各种软件包了。无论是开发工具wget、git，还是日常应用chrome、wechat，都可以通过简单的brew install命令一键搞定。

如果在安装过程中遇到任何问题，欢迎在评论区留言讨论！