macOS国内安装Homebrew

Posted on Views:

1. 什么是 Homebrew

  • Homebrew 是 macOS 上一个非常流行的包管理器，用于安装、更新、管理软件包。
  • 目的是让用户可以像在 Linux 上用 apt / yum 那样便捷管理软件。

2. 安装前准备

  • 要求 macOS 版本 ≥ Monterey（12.0）或更高

  • 需要安装 Command Line Tools（CLT），可通过下面命令安装：

    1
    xcode-select --install

macos Monterey(12.x) Command_Line_Tools_for_Xcode_14.2/0

3. 安装方式

方法 命令 / 说明 优点 / 适用场景 风险 / 注意点
国内镜像安装（推荐） /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)" 对国内用户友好，速度快 脚本可信性需确认
官方安装脚本 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 标准方法、更新及时 在国内可能下载慢或失败
Git 克隆安装 sudo git clone https://github.com/Homebrew/brew /opt/homebrew 更自由、可控 需后续配置环境、更新路径等

推荐国内镜像版本 + 后续镜像配置。

4. 配置国内镜像源

镜像替换命令（以 USTC 为例）：

正常最新的安装会提示是否设置国内源，以下仅作了解

1
2
3
4
5
6
7
8
# 替换 brew 主仓库
git -C "$(brew --repo)" remote set-url origin https://mirrors.ustc.edu.cn/brew.git

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

# 替换 Homebrew Cask
git -C "$(brew --repo homebrew/cask)" remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git

恢复官方源，可以把这些 remote set-url 命令反过来执行，恢复到 GitHub 官方地址。

5. 验证安装

  • brew --version：查看 Homebrew 版本
  • brew doctor：检测环境状态

如果一切正常，说明安装成功、环境就绪。

6. 常见问题与解决

  • 权限问题：某些目录的读写权限可能不对，需要 chown 改变所有权

    1
    sudo chown -R $(whoami) $(brew --prefix)/*

  • 更新失败 / 拉取慢：可能是镜像源配置问题，建议检查 remote URL 是否正确

  • 恢复镜像源：如果未来想回到官方源，可以恢复 Git remote URL