news 2026/4/30 23:12:24

brew@认识homebrew基本概念@国内源配置@加速配置@一键安装方案

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
brew@认识homebrew基本概念@国内源配置@加速配置@一键安装方案

文章目录

    • abstract
    • 文档和手册
      • homebrew相关术语和概念
      • 安装目录
    • Homebrew 术语
      • 概念关系示意图
      • 展开解释
        • Formula (配方)
        • Bottle (瓶装酒)
        • Cask (酒桶)
        • Cellar (酒窖)
        • Keg (小酒桶)
        • Tap (水龙头)
        • Bundle (捆绑包)
      • cellar和rack
      • 简介
    • 关于prefix和opt prefix
      • 1. Unix 传统的传承
      • 2. 在 Homebrew 中的核心作用：符号链接（Symlink）
      • 环境变量
    • 国内配置brew加速
      • 核心加速点 (Components)
    • brew配置信息查看
      • brew info 查询软件包信息
    • 主要配置流程
      • 第一步：设置环境变量（临时生效或写入配置文件）
      • 第二步：更换常规仓库远程地址 (Permanent)
      • 第三步：刷新配置
    • 针对不同架构的路径要点
    • 自动化安装/换源脚本
      • 方案1
      • 方案2

abstract

  • macOS（或 Linux）缺失的软件包的管理器 — Homebrew

使用 Homebrew 安装 Apple（或您的 Linux 系统）没有预装但 你需要的东西。

Homebrew 会将软件包安装到独立目录，并将其文件软链接至/opt/homebrew。

Homebrew 不会将文件安装到它本身目录之外，所以您可将 Homebrew 安装到任意位置

  • 但是对于linuxbrew(Linux 上的 Homebrew — Homebrew 文档 — Homebrew on Linux — Homebrew Documentation),建议的目录是/home/linuxbrew/.linuxbrew.
  • 理论上，你可以将 Homebrew 安装到任何你想要的位置。但是，你不应该安装在默认、受支持且最佳的前缀之外。在默认前缀之外，很多东西都需要从源代码构建。从源代码构建速度慢、能耗高、容易出错且不受支持。Homebrew 之所以能正常工作，主要原因是它使用 bottle（二进制软件包），而大多数 bottle 都需要使用默认前缀。
  • 选择前缀/home/linuxbrew/.linuxbrew是为了避免安装后写入系统目录，同时仍然允许使用大多数预编译二进制文件（bottles）。Homebrew 是为单用户安装而设计的，而不是为共享角色帐户而设计的。

文档和手册

  • brew(1) – The Missing Package Manager for macOS (or Linux) — Homebrew Documentation
  • 或者在brew已经安装的情况下,通过输入man brew查询本地手册;

homebrew相关术语和概念

Formula Cookbook — Homebrew Documentation

安装目录

以macos上的homebrew目录为例:

# cxxu @ CxxuMac in /opt/homebrew on git:stable o [22:22:19]$ls-d*/ bin/ Cellar/ docs/ Frameworks/ lib/ manpages/ package/ share/ Caskroom/ completions/ etc/ include/ Library/ opt/ sbin/ var/(base)

Homebrew 术语

术语描述示例
formula从上游源码构建的 Homebrew包定义/opt/homebrew/Library/Taps/homebrew/homebrew-core/Formula/f/foo.rb
cask安装由上游构建并签名的预编译二进制文件的 Homebrew包定义/opt/homebrew/Library/Taps/homebrew/homebrew-cask/Casks/b/bar.rb
prefixHomebrew 安装路径/opt/homebrew,/home/linuxbrew/.linuxbrew
keg给定formula版本的安装目标目录/opt/homebrew/Cellar/foo/0.1
rack包含一个或多个版本化kegs的目录/opt/homebrew/Cellar/foo
keg-only如果formula未符号链接到 Homebrew 的 prefix 中，则称为keg-onlyopenjdkformula
opt prefix指向keg活动版本的符号链接/opt/homebrew/opt/foo
Cellar包含一个或多个命名racks的目录/opt/homebrew/Cellar
Caskroom包含一个或多个命名casks的目录/opt/homebrew/Caskroom
tapformulae、casks和/或外部命令的目录（通常是 Git 仓库）/opt/homebrew/Library/Taps/homebrew/homebrew-core
bottle预构建的keg，直接倒入Cellar的rack中，而不是从上游源码构建qt--6.5.1.ventura.bottle.tar.gz
tab关于keg的信息，例如它是从bottle倒入还是从源码构建/opt/homebrew/Cellar/foo/0.1/INSTALL_RECEIPT.json
Brew BundleHomebrew 的声明式接口brew 'myservice', restart_service: true
Brew Services管理后台服务的 Homebrew 命令brew services start myservice

Homebrew 的术语体系充满了“酿酒”的趣味，理解它们能让你更好地掌握这个工具。

opt prefix在用户和具体的软件(版本)安装路径中间加了一层,对于同名软件的多个不同版本,这样处理隐藏了具体的版本号;

$type-ashfmt shfmt is /opt/homebrew/bin/shfmt# 查看符号链接的指向(查看软件当前指向的版本(keg))$type-aSshfmt shfmt is /opt/homebrew/bin/shfmt ->/opt/homebrew/bin/../Cellar/shfmt/3.13.1/bin/shfmt

概念关系示意图

定义

定义

构建/倒出

倒入

符号链接

符号链接 (非 Keg-only)

Prefix (Homebrew 根目录)
/opt/homebrew

Cellar (地窖)
存储所有 Formula 安装包

Rack (货架)
软件名目录 (如: foo)

Keg (小桶)
具体版本目录 (如: 0.1)

Tab (标签)
安装信息 (INSTALL_RECEIPT.json)

Caskroom (木桶房)
存储所有 Cask 预编译包

Cask (木桶)
软件安装目录 (如: bar)

Tap (水龙头/仓库)
源码/定义集合 (Git Repo)

Formula (配方)
源码构建定义 (.rb)

Cask (木桶定义)
二进制包定义 (.rb)

Bottle (瓶装)
预编译二进制包

opt prefix (活动版本链接)
/opt/homebrew/opt/foo

/opt/homebrew/bin (可执行文件)

图表要点说明：

  • 层级包含关系：Cellar(地窖) 包含多个Rack(货架)，每个Rack下有不同版本的Keg(小桶)。这完美对应了 Homebrew 这种类比酿酒厂的命名方式。
  • 安装来源：Formula（配方）决定了如何通过源码或Bottle（预编译好的瓶装包）来填充Keg。
  • 访问方式：为了方便调用，当前活跃的Keg会被链接到opt prefix，如果不是keg-only的软件，它的可执行文件最终会出现在系统的bin路径下。
  • Cask 的区别：Caskroom与Cellar并列，专门用于处理那些预编译好的 GUI 程序或二进制应用（如 Chrome, Docker 等）。

展开解释

Formula (配方)
  • 字面意思：公式，配方。
  • 地道解释：这是 Homebrew 的核心，一个用 Ruby 语言编写的脚本文件。它定义了如何下载、编译和安装一个软件包。当你执行brew install <软件名>时，Homebrew 就是在执行对应的 Formula。复数形式为Formulae。
Bottle (瓶装酒)
  • 字面意思：瓶子。
  • 地道解释：指预先编译好的软件包。就像买一瓶已经酿好的酒，你无需自己从头开始“酿酒”（即从源码编译），可以直接下载安装。绝大多数官方软件都是通过 Bottle 方式安装的。
Cask (酒桶)
  • 字面意思：（装酒的）木桶。
  • 地道解释：这是 Homebrew 的扩展，专门用来安装macOS的图形界面（GUI）应用程序，比如 Chrome、VS Code 等。通过brew install --cask <应用名>命令，你就可以在命令行里轻松安装这些带界面的软件。
Cellar (酒窖)
  • 字面意思：地窖，酒窖。
  • 地道解释：这是所有通过 Homebrew 安装的软件的“大本营”，即它们的总安装目录。所有软件都会被规规矩矩地存放在这个“酒窖”里，不会弄乱你的系统。
    • Apple Silicon (M系列芯片)的默认路径是：/opt/homebrew
    • Intel 芯片的默认路径是：/usr/local
Keg (小酒桶)
  • 字面意思：（装啤酒的）小桶。
  • 地道解释：Cellar的子目录。每一个具体版本的软件包都会被安装在Cellar里的一个独立Keg中。例如，/opt/homebrew/Cellar/git/2.41.0就是一个 Keg。这种设计让版本切换和管理变得异常简单。
Tap (水龙头)
  • 字面意思：水龙头，栓口。
  • 地道解释：指 Homebrew 的软件仓库源。默认情况下，Homebrew 有homebrew-core（核心库）和homebrew-cask（图形应用库）两个官方 Taps。你也可以通过brew tap命令添加第三方的 Taps，来获取更多社区维护的软件包。
Bundle (捆绑包)
  • 字面意思：捆，束。
  • 地道解释：用于描述一组 Homebrew 软件包及其依赖关系。它允许你通过一个文件来定义和安装一整套开发环境或工具集，方便在不同机器间同步配置。

cellar和rack

以下面到例子为例:

# cxxu @ CxxuMac in /opt/homebrew/Cellar/openssl@3 on git:stable o [23:19:08]$ls3.6.13.6.2

openssl@3是rack(软件名),而这个rack中有软件的不同版本的(keg)

$type-aSopenssl openssl is /opt/homebrew/bin/openssl ->/opt/homebrew/bin/../Cellar/openssl@3/3.6.2/bin/openssl

其中/opt/homebrew/bin/../Cellar/openssl@3/3.6.2/bin/openssl是软件的最终的可执行文件路径.

简介

Homebrew 使用 Git 存储 formula 并为项目做贡献。

从 Homebrew 4.0.0 开始，formulae 以 JSON 格式从 https://formulae.brew.sh 下载，该网站由定时任务自动从 Homebrew/homebrew-core 仓库的默认分支重新生成。

Homebrew 将formulae安装到$(brew --cellar)的 Cellar 中，然后将部分安装内容符号链接到$(brew --prefix)的 prefix 中（例如/opt/homebrew），以便其他程序可以看到安装内容。

建议在你的 Cellar 中对几个 kegs 运行brew ls来了解其排列方式。

包是根据其formula安装的。

阅读一个简单的 formula，例如brew edit etl（或 etl.rb），或一个更高级的，例如brew edit git（或 git.rb）。

关于prefix和opt prefix

  • prefix(homebrew prefix):主要是指homebrew安装目录;
  • opt prefix:在 Homebrew 的语境下，opt这个词并不是随机选择的，它背后有着 Unix 系统的传统逻辑和 Homebrew 特有的版本管理机制。

opt既代表Optional（第三方软件目录），也代表了 Homebrew 的优化访问层。它通过提供一个“永久固定”的地址，屏蔽了底层软件版本更迭带来的路径变化。

1. Unix 传统的传承

在传统的 Unix 文件系统层次结构（Filesystem Hierarchy Standard）中，/opt目录代表“optional”（可选的）。

  • 它通常用于存放那些不属于操作系统核心部分的软件，或者由第三方供应商提供的软件包。
  • Homebrew 沿用了这个命名习惯，将它管理的所有软件包放在这个目录下。

2. 在 Homebrew 中的核心作用：符号链接（Symlink）

虽然 Homebrew 的软件真正下载和解压的地方是在/opt/homebrew/Cellar（窖藏），但直接引用 Cellar 里的路径会非常麻烦，因为路径里包含了具体的版本号。

这就是opt目录发挥威力的地方。它存放的是指向当前活动版本（active version）的符号链接（Symbolic Links）。

为什么要这么做？

我们可以通过下面这个例子来理解：

路径类型实际路径示例存在的问题/优点
真实路径 (Cellar)/opt/homebrew/Cellar/foo/1.2.3/软件升级到 1.2.4 后，旧路径就会失效。
优化路径 (opt)/opt/homebrew/opt/foo/始终有效。它永远指向当前最新的版本。

homebrew会自动维护opt中的符号链接指向,默认情况下指向最新版本;

  • 版本无关性：你在配置环境变量（如PATH或LDFLAGS）时，只需要指向opt/foo。这样即使你通过brew upgrade升级了软件，你的配置文件也不需要做任何修改。
  • 平滑切换：Homebrew 只需要更改opt/foo这个“快捷方式”的目标，就能瞬间完成版本的切换。

在windows平台的scoop有类似的手法;

环境变量

ENVIRONMENT 环境变量

国内配置brew加速

Module: Homebrew::EnvConfig — Homebrew Ruby API

在国内配置 Homebrew 加速，本质上是将 Homebrew 的各个组成部分（基础工具、核心配方库、预编译二进制包）的下载地址从 GitHub/Amazon S3 切换到国内的镜像服务器（如中科大 USTC、清华 TUNA 或阿里云）。

以下是配置加速的三个主要核心要点和操作流程：

核心加速点 (Components)

要达到完全加速，配置以下几个部分(尤其是前2个)：

  • Brew Repo: Homebrew 程序本身的源代码（Git 仓库）。
  • Homebrew Bottles: 预编译好的二进制包（最影响下载速度的部分）。

brew4.0后,下面的两个配置项不再必须,考虑兼容性,可以按需配置:

  • Core Repo (Formulae): 核心软件包定义文件，决定了brew install搜什么、怎么装。
  • (*)Case Repo(for MacOs):针对Macos的应用,主要是GUI程序;linux系统一般不用关心;

替换homebrew为国内镜像加速有两类方案:

  • homebrew镜像环境变量配置方案
  • homebrew相关的git仓库绑定源更换

常见 Homebrew 国内镜像源大全

以中科大源为例:

  1. Homebrew 源代码仓库Homebrew - USTC Mirror Help
  2. Homebrew预编译二进制软件包与软件包元数据文件Homebrew Bottles - USTC Mirror Help

Brew 4.0 版本后默认使用元数据 JSON API 获取仓库信息，因此在大部分情况下都不再需要进行如下配置。可参考homebrew-bottles进行相关配置。

  • Homebrew 核心软件仓库Homebrew Core - USTC Mirror Help

  • *Homebrew cask 软件仓库，提供macOS应用和大型二进制文件Homebrew Cask - USTC Mirror Help

    针对于macos(linux用户不用关心)brew tap --custom-remote homebrew/cask https://mirrors.ustc.edu.cn/homebrew-cask.git

# Homebrew 源代码仓库exportHOMEBREW_BREW_GIT_REMOTE="https://mirrors.ustc.edu.cn/brew.git"# Homebrew 预编译二进制软件包与软件包元数据文件exportHOMEBREW_BOTTLE_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles"exportHOMEBREW_API_DOMAIN="https://mirrors.ustc.edu.cn/homebrew-bottles/api"# Homebrew 核心软件仓库(Brew 4.0 版本后默认使用元数据 JSON API 获取仓库信息，因此在大部分情况下都不再需要进行如下配置。可参考 homebrew-bottles 进行相关配置。)exportHOMEBREW_CORE_GIT_REMOTE="https://mirrors.ustc.edu.cn/homebrew-core.git"brew update

brew配置信息查看

使用brew config命令,Homebrew 会列出当前环境下生效的所有配置及其说明：

(base)#( 04/22/26@10:17PM )( cxxu@CxxuMac ):~/sh@main✗✗✗brew config HOMEBREW_VERSION:5.1.7 ORIGIN: https://mirrors.ustc.edu.cn/brew.git HEAD: 3aae056b8d072624255bc8fd27febb7f327b2265 Last commit:5days ago Branch: stable Core tap JSON:22Apr13:56 UTC Core cask tap JSON:22Apr13:56 UTC HOMEBREW_PREFIX: /opt/homebrew HOMEBREW_API_DOMAIN: https://mirrors.ustc.edu.cn/homebrew-bottles/api HOMEBREW_BOTTLE_DOMAIN: https://mirrors.ustc.edu.cn/homebrew-bottles HOMEBREW_CASK_OPTS:[]HOMEBREW_DOWNLOAD_CONCURRENCY:20HOMEBREW_FORBID_PACKAGES_FROM_PATHS:setHOMEBREW_MAKE_JOBS:10HOMEBREW_PIP_INDEX_URL: https://pypi.mirrors.ustc.edu.cn/simple Homebrew Ruby:4.0.2=>/opt/homebrew/Library/Homebrew/vendor/portable-ruby/4.0.2_1/bin/ruby CPU: deca-core64-bit dunno Clang:21.0.0 build2100Git:2.53.0=>/opt/homebrew/bin/git Curl:8.7.1=>/usr/bin/curl macOS:26.4.1-arm64 CLT:26.4.1.0.1775747724 Xcode: N/A Rosetta2:false

brew info 查询软件包信息

以curl为例:

(base)#( 04/22/26@11:05PM )( cxxu@CxxuMac ):~/sh@main✗✗✗brew infocurl==>curl✔: stable8.19.0(bottled), HEAD[keg-only]Get afilefrom an HTTP, HTTPS or FTP server https://curl.se Installed(on request)/opt/homebrew/Cellar/curl/8.19.0(551files,4.7MB)Poured from bottle using the formulae.brew.sh API on2026-04-15 at23:06:20 From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/c/curl.rb License:curl==>Dependencies Required(7): brotli ✔, libnghttp2 ✘, libnghttp3 ✔, libngtcp2 ✘, libssh2 ✔, openssl@3 ✔, zstd ✔ Recursive Runtime(10):10✔,0✘==>Options--HEADInstall HEAD version==>Caveatscurlis keg-only,whichmeans it was not symlinked into /opt/homebrew, because macOS already provides this software and installing another versioninparallel can cause all kinds of trouble. If you need to havecurlfirstinyourPATH, run:echo'export PATH="/opt/homebrew/opt/curl/bin:$PATH"'>>~/.zshrc For compilers tofindcurlyou may need to set:exportLDFLAGS="-L/opt/homebrew/opt/curl/lib"exportCPPFLAGS="-I/opt/homebrew/opt/curl/include"==>Downloading https://mirrors.ustc.edu.cn/homebrew-bottles/api/formula/curl.json

这里的Caveats(注意事项)指出,curl是keg-only,也就是说它不会为用户在brew prefix目录中创建符号链接;

这类系统自带软件(虽然不是最新新版)的情况下,homebrew可以安装新版,但是会归类为keg-only,防止造成意外问题.

如果用户坚持使用brew安装的版本,则需要修改环境变量,上述的输出已经给出提示:

echo 'export PATH="/opt/homebrew/opt/curl/bin:$PATH"' >> ~/.zshrc(或者其他shell的配置文件中)

主要配置流程

第一步：设置环境变量（临时生效或写入配置文件）

这是最快的方法。

在终端执行以下命令，可以让当前的安装进程直接走国内镜像：

# 以清华镜像源为例 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"

第二步：更换常规仓库远程地址 (Permanent)

为了配置固化,以后每次使用都快，需要修改 Git 的远程仓库地址：

依然以清华源为例

  1. 修改 brew.git:

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

  2. 修改 homebrew-core.git:

    cd"$(brew--repo)/Library/Taps/homebrew/homebrew-core"gitremote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git

第三步：刷新配置

执行更新命令，确保所有索引指向镜像站：

brew update

针对不同架构的路径要点

根据我们之前的示意图，不同架构的 HomebrewPrefix不同，这会影响你寻找配置文件的位置：

架构类型Prefix 路径 (根目录)配置文件位置 (常见)
Apple Silicon (M1/M2/M3)/opt/homebrew~/.zshrc
Intel Mac/usr/local~/.bash_profile或~/.zshrc
Linux/home/linuxbrew/.linuxbrew~/.bashrc

自动化安装/换源脚本

如果你觉得手动配置太麻烦，国内目前最流行的“一键安装/换源”方案:

方案1

# 自动选择最快镜像源的一键脚本 (由国内开发者维护) /bin/zsh -c "$(curl -fsSL https://gitee.com/cunkai/HomebrewCN/raw/master/Homebrew.sh)"

方案2

非交互式安装,通过指定选项完成安装;

兼容GNU/linux系统

source<(curl-fsSLhttps://raw.giteeusercontent.com/xuchaoxin1375/scripts/raw/main/wp/woocommerce/woo_df/sh/shell_utils.sh)install_brew_cn# 添加-h选项查看帮助(默认使用ustc源安装)
版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/4/30 23:11:25

MyBatis动态SQL避坑指南：处理‘＞=‘、‘＜=‘等符号，用转义还是CDATA？看完这篇不再纠结

MyBatis动态SQL中特殊符号处理的深度实践指南 1. 问题背景与核心痛点 在电商后台系统的商品筛选模块开发中&#xff0c;我们经常需要构建包含价格区间、库存数量等多重条件的动态SQL查询。上周团队新来的工程师小王就遇到了一个典型问题——他在MyBatis的XML映射文件中编写的范…

作者头像 李华
网站建设 2026/4/30 23:10:09

TouchGal完整指南：构建现代化Galgame社区的终极解决方案

TouchGal完整指南&#xff1a;构建现代化Galgame社区的终极解决方案 【免费下载链接】kun-touchgal-next TouchGAL是立足于分享快乐的一站式Galgame文化社区, 为Gal爱好者提供一片净土! 项目地址: https://gitcode.com/gh_mirrors/ku/kun-touchgal-next TouchGal是一个基…

作者头像 李华
网站建设 2026/4/30 23:10:07

输入法词库转换终极指南：如何实现20+主流输入法词库自由迁移

输入法词库转换终极指南&#xff1a;如何实现20主流输入法词库自由迁移 【免费下载链接】imewlconverter ”深蓝词库转换“ 一款开源免费的输入法词库转换程序 项目地址: https://gitcode.com/gh_mirrors/im/imewlconverter 还在为更换输入法时辛苦积累的个人词库无法迁…

作者头像 李华
网站建设 2026/4/30 23:09:43

XZ6930输入电压4-20V 可编程LED驱动电流10mA至1.2A

XZ6930是一款20V/1.2A高效率降压型恒流LED驱动器&#xff0c;专为高效驱动单个或多个串联LED而设计。该器件可在4V至20V的输入电源电压范围内工作&#xff0c;并提供外部可调、最高达1.2A的输出电流。根据电源电压和外部元件的不同&#xff0c;XZ6930可驱动功率达10W的LED阵列。…

作者头像 李华
网站建设 2026/4/30 23:08:29

前端面试复习｜03项目篇

前端面试复习&#xff5c;项目篇 涵盖&#xff1a;实时通信 / ECharts / 地图 SDK / 工程化 / 项目难点话术 / 简历项目 Q&A 复习时长建议&#xff1a;1 周 &#x1f4d1; 目录 实时通信&#xff08;WebSocket / WebRTC / MQTT&#xff09;ECharts 数据可视化地图 SDK 与电…

作者头像 李华
网站建设 2026/4/30 23:08:28

Taotoken用量看板如何帮助团队精细化管理大模型API成本

Taotoken用量看板如何帮助团队精细化管理大模型API成本 1. 用量看板的核心功能 Taotoken控制台提供的用量看板为团队管理者提供了多维度的API调用数据可视化。在控制台的「用量分析」页面&#xff0c;系统默认展示最近30天的token消耗趋势图&#xff0c;支持按自然日或小时粒…

作者头像 李华