Homebrew 安装使用（Ubuntu 完整实操版）

0. 前言

Homebrew 支持绝大部分系统软件服务的安装，如 ollama, ffmpeg, mysql 等

在非 root 用户下安装使用，mac 和 linux(ubuntu) 上都可以使用

1. 操作步骤

1.1 确认 curl 和 git 是否已安装（可跳过）

# 分别查看是否安装 curl 和 git（输出版本号则已安装）
curl -V
git -v

注：若未安装，可以通过类似 sudo apt install curl git 的命令进行安装（一般先执行 sudo apt update）

1.2 设置镜像源（临时）（灵活）

# 设置清华镜像源：五行一起拷贝执行
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api" && 
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles" && 
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" && 
export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

1.3 安装

# 从清华源下载安装脚本（也可以从GitHub下载：https://github.com/Homebrew/install/raw/master/install.sh）
git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install

# 执行安装脚本（输入密码后，一直回车即可）
bash brew-install/install.sh

注：安装成功后会输出一些后续的命令提示，也会在后续步骤继续操作

1.4 配置环境变量

# 环境变量在哪个文件配置以 brew 提示为准，Mac、Linux 等可能不太一样
(echo; echo 'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"') >> ~/.bashrc
eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv)"

1.5 验证是否可用（可跳过）

# 输出版本号则安装成功（不成功可以先试试 source ~/.bashrc）
brew -v

1.6 设置镜像源（长期）（灵活）

# 编辑配置文件
vim ~/.bashrc
# 文件末尾加入以下内容
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
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"
export HOMEBREW_PIP_INDEX_URL="https://pypi.tuna.tsinghua.edu.cn/simple"

# 刷新环境变量
source ~/.bashrc

1.7 安装系统依赖项（灵活）

# 安装 build-essential
sudo apt update
sudo apt install build-essential

1.8 清理安装脚本（灵活）

# 清理/归档安装脚本（之前在哪下载的，在哪处理）
rm -rf brew-install

1.9 使用

# 更新
brew update

# 安装指定软件
brew install xxx

# 查看所有已安装软件
brew list

# 卸载指定软件
brew uninstall xxx

2. 参考资料

2.1 homebrew

官网

https://brew.sh/brew.sh/

2.2 清华大学开源软件镜像站

Homebrew 软件仓库

homebrew | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirrormirrors.tuna.tsinghua.edu.cn/help/homebrew/

3. 资源

3.1 homebrew

GitHub

Homebrew/install: Homebrewgithub.com/Homebrew/install/raw/master/install.sh
Homebrew/install: Homebrewgithub.com/Homebrew/install

3.2 清华大学开源软件镜像站

Homebrew Bottles 软件仓库

homebrew-bottles | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirrormirrors.tuna.tsinghua.edu.cn/help/homebrew-bottles/

4. 相关文章

4.1 镜像源

IF2116：homebrew 镜像源「配置」0 赞同 · 0 评论 文章

4.2 环境配置

IF2116：Homebrew 安装
 
(2 封私信) Homebrew 安装使用（Ubuntu 完整实操版） - 知乎
 

Homebrew 对于使用 Mac 的开发者来说，是再熟悉不过的了，它可以在 macOS 中方便的安装和管理各种系统并不自带的开发包。但令人苦恼的是很多时候它的下载和更新速度太慢，让人非常头疼，今天 Gitee 为各位推荐的就是在国内自动安装 Homebrew 的脚本。

项目名称：HomebrewCN

项目作者：CunKai

项目地址：gitee.com/cunkai/Homebr

脚本内容

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

只需要把这段脚本内容复制到「终端」中即可。

脚本效果

运行后我们可以看到，共有 4 个下载源可供选择，这时输入选择下载源的序号即可。

这时我们就可以看到速度有多么的快了，Gitee 表示安装 Homebrew 从来没有这么舒爽过！

常见错误说明

（转载自作者知乎专栏：zhuanlan.zhihu.com/p/11）

1.Mac 10.11系统版本以下的（包括10.11），brew官方已经停止对这类老系统的支持。

2.如果遇到报错中含有errno 54 / 443 / 的问题：

这种一般切换源以后没有问题，因为都是公益服务器，不稳定性很大。

3.检测到你不是最新系统，需要自动升级Ruby后失败的：

rm -rf /Users/$(whoami)/Library/Caches/Homebrew/


brew -v

如果还失败运行下面的脚本：

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

4.如果报错 command not found : brew

先运行下面命令看是否能出来Homebrew的版本号（结果看倒数3句）

/usr/local/Homebrew/bin/brew -v

再运行设置临时PATH的代码：

export PATH=/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin


brew -v

如果能用就是电脑PATH配置问题，重启终端运行echo $PATH打印出来自己分析一下。

5.如果brew -v没有报错 ， brew update出错的：

这种不影响使用，尝试再次运行brew update可能赶上服务器不稳定的一瞬间。

6.brew有一个自检程序，如果有问题自检试试：

/usr/local/bin/brew doctor

提示github的地址问题不用在意，因为换成国内地址了，所以警告。

【Mac必备】2026年国内安装&配置Homebrew全攻略（中科大/清华镜像 + 一键脚本）】_mac homebrew-CSDN博客

Mac必备】2026年国内高速安装&配置Homebrew全攻略（中科大/清华镜像 + 一键脚本）

在用国内Homebrew（macOS/Linuxbrew的神器）最烦的就是：

  • 官方安装脚本卡在git fetch或curl 56 Connection reset by peer
  • brew update慢如龟速
  • brew install大包（如node、python、ffmpeg）下载几十KB/s，卡半天

这些问题99%是因为网络对GitHub的访问不稳定或限速。
好消息是：通过国内镜像源，可以把速度提升到几MB/s ~ 十几MB/s，安装和更新基本秒开！

本文整理了2026年最稳定、推荐的几种方式（实测有效），包括：

  • 一键脚本（最懒人）
  • 中科大镜像（目前最稳定，同步快）
  • 清华金枪鱼（瓶子下载特别环保）
  • 常见问题排查

适用于Apple Silicon (M1/M2/M3/M4 Mac mini 等)和Intel Mac。

一、为什么一定要用国内镜像？

问题类型 官方来源表现 国内表现
git 克隆/获取 经常提早 EOF/重置 稳定，级完成
酿造更新 三十～十几分钟 几秒～几十秒
酿造安装瓶 几十KB/s~几十KB/s 5-20MB/s+（视网络）
API 元数据 (formula.json) 经常超时 返回瞬间

核心配置其实就几行环境变量，Homebrew从4.0+开始默认走API，大部分用户不需要再手动克隆核心仓库了！

二、最推荐方式：一键安装脚本（HomebrewCN）

如果你是新手或重装，直接用这个脚本最省事。它会让你选择镜像源（中科大/清华/阿里等），自动配置，基本一次过。

# macOS 默认 zsh，用这个（bash 用户把 zsh 改 bash 即可）
/bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"
狂欢
 

运行后：

  1. 出现选项菜单，选择1（中科大源）或2（清华源）（推荐中科大，同步最及时）
  2. 它会自动处理 sudo、下载、配置环境变量
  3. 安装完成后验证：
brew --version
brew update   # 应该飞快
brew doctor   # 检查问题
狂欢
 

优点：傻瓜式，自动选最优化源，适合99%用户。
缺点：依赖Gitee，如果Gitee偶尔抽风，可用下面手动方式。

三、手动方式：永久配置中科大镜像（2026推荐首选）

中科大镜像目前同步频率最高、瓶子最全、稳定性强。

步骤

  1. 清理残留（防止冲突，Apple Silicon 使用/opt/homebrew）
sudo rm -rf /opt/homebrew
# 如果是 Intel Mac： sudo rm -rf /usr/local/Homebrew
狂欢
 
  1. 编辑 shell 配置文件（macOS 默认 zsh，用 ~/.zshrc；bash 使用 ~/.bash_profile 或 ~/.bashrc）
nano ~/.zshrc
# 或 vim ~/.zshrc
狂欢
 
  1. 在文件补充添加以下内容（完整推荐配置）：
# ===================== Homebrew 国内镜像加速（中科大 USTC） =====================
# Homebrew 核心仓库（brew.git）
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"

# 如果需要开发命令（如 brew cat formula），才设置 core（大多数人可省略）
# export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"

# Cask（图形软件）镜像，可选但推荐
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-cask.git"

# 二进制瓶子（bottles）加速 - 下载速度关键！
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"

# API 元数据加速（formula.json 等，brew 4.0+ 默认用这个，超级重要）
export HOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"

# 可选：禁止自动更新（想手动控制时加）
# export HOMEBREW_NO_AUTO_UPDATE=1
# ===================== 配置结束 =====================
狂欢
 

保存退出（纳米：Ctrl+O → 回车 → Ctrl+X）

  1. 立即生效
source ~/.zshrc
狂欢
 
  1. 安装自制程序
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
狂欢
 
  • 安装过程会自动走你设定的想象，速度飞跃。
  • 安装完成后按照提示eval "$(/opt/homebrew/bin/brew shellenv)"添加到~/.zprofile（Apple Silicon）或 ~/.bash_profile（Intel）。
  1. 验证
brew update   # 看是否走 mirrors.ustc.edu.cn
brew install gh   # 测试安装一个小的，观察下载地址和速度
狂欢
 

四、创业：清华金枪鱼镜像配置

如果中科大偶尔不稳定，换清华（瓶子下载特别习惯）：

替换上面export中的地址为：

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"  # 大多数人可不设
export HOMEBREW_CASK_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git"
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"
export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"
狂欢
 

然后source ~/.zshrc，再酿造更新。

五、常见问题及排查

  1. 还是卡在 git fetch / Early EOF
    → 换手机热点试试（家/公司网络常被限速）
    → 加 git 缓冲：git config --global http.postBuffer 524288000

  2. brew update 还是慢
    → echo $HOMEBREW_API_DOMAIN 检查是否有效
    → 取消设置所有参数对比官方速度，确认是网络问题

  3. 想恢复官方源
    unset所有HOMEBREW_目录的导出，然后brew更新。

  4. M4 Mac mini 注意
    路径是/opt/homebrew，命令前加 eval “$(/opt/homebrew/bin/brew shellenv)” 已自动处理。

六、结语

使用上镜像后，Homebrew 真正变成了“家常便饭”工具：

  • brew install wget git node python ffmpeg …… 基本几十秒搞定
  • 再也不用半夜等下载了

顺序推荐：

  1. 先试 HomebrewCN 一键脚本（懒人做）
  2. 手动永久配置中科大源（稳定党首选）
  3. 清华源作为备用

有任何错误欢迎评论区贴出来，一起解决～
喜欢的事情点个赞+收藏，帮助到更多Mac开发者！

 

posted @ 2026-04-10 15:35  charyGao  阅读(99)  评论(0)    收藏  举报