macOS 安装 Homebrew 指南

1. 简介

Homebrew 是 macOS 下最受欢迎的软件包管理器，用于方便地安装和管理各种开发工具和库。

2. 安装要求

  • macOS 10.14 或更高版本
  • 已安装 Xcode 或 Command Line Tools

3. 安装步骤（直接安装可能需要网络加速）

步骤 1：打开终端 Terminal

使用快捷键 Command + Space 搜索并打开“终端”。

步骤 2：执行安装命令

复制以下命令粘贴到终端中执行：

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

步骤 3：根据提示完成安装

安装过程将自动检测系统并提示你输入密码，请根据提示完成安装。

步骤 4：配置环境变量（Apple Silicon 用户）

如果你是 M1/M2/M3 芯片 用户，需要将 Homebrew 的路径加入环境变量：

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

步骤 5：验证安装

执行以下命令确认安装成功：

brew --version

输出版本号即表示安装成功。

4. 无代理环境下的安装方案（国内用户适用）

如果因为网络问题无法直接安装，建议使用清华镜像源并运行国内安装脚本，安装速度更快、更稳定。

方法一：使用 Gitee 国内安装脚本（推荐）

  1. 设置环境变量（可选）：
export HOMEBREW_BREW_GIT_REMOTE=https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
export HOMEBREW_CORE_GIT_REMOTE=https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
  1. 执行 Gitee 脚本安装：
/bin/bash -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

脚本支持选择使用清华源、中科大、腾讯等镜像源。

项目地址：https://gitee.com/cunkai/HomebrewCN

方法二：安装后配置国内镜像源

安装完成后，执行以下命令配置国内镜像：

# 替换 Homebrew 主仓库源
git -C "$(brew --repo)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git

# 替换 Core 源
git -C "$(brew --repo homebrew/core)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

# 替换 Cask 源（可选）
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git

5. 常用命令

brew install <package>      # 安装软件包
brew uninstall <package>    # 卸载软件包
brew update                 # 更新 Homebrew 本体
brew upgrade                # 升级已安装的软件包
brew list                   # 查看已安装的包

6. 参考链接

  • 官方网站：https://brew.sh
  • 清华源说明：https://mirrors.tuna.tsinghua.edu.cn/help/homebrew/
  • Gitee 安装脚本项目：https://gitee.com/cunkai/HomebrewCN