MacOS软件包管理器--brew

发表于 更新于 分类于 置顶 精品
阅读次数： 本文字数： 4.6k 阅读时长 ≈ 17 分钟

摘要

  • brew是一个软件包管理器，同时支持MacOS和Linux，可以很方便地安装各种软件，比如git、node、python等。

  • brew虽然支持linux，但是实际使用中很少会使用brew来管理linux的软件包。

  • 本文介绍如何在macos下安装brew，以及如何使用brew管理各种软件包。

  • 本文基于 MacOS Intel Ventura 13.7.1，brew 版本为4.4.8。

安装

  • 首先要确保系统中安装了 git 和 curl，对于 macOS 用户来说，这些系统都自带了，唯一需额外要求安装的是Command Line Tools (CLT) for Xcode。

1
2
3
4
5
6
7
8
# 检查系统中是否安装了 Command Line Tools (CLT) for Xcode
xcode-select --version # 能够输出版本号说明安装了，否则需要安装。

# 安装 Command Line Tools (CLT) for Xcode
xcode-select --install

# 打印当前的 Command Line Tools (CLT) for Xcode 的安装路径
xcode-select -p # /Library/Developer/CommandLineTools

在MacOS上安装brew的方法

方法一：使用脚本安装

1
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
1
2
3
4
5
6
7
# 控制了 Homebrew 在安装软件包时是否从 Homebrew 的 API 服务器获取信息，brew4.0后是默认行为，无需设置
export HOMEBREW_INSTALL_FROM_API=1
# 设置brew仓库上游
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
# 设置homebrew核心上游
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

方法二：使用PKG文件安装

方法三：国内无法访问github地址时可以使用国内镜像源

  • 这里依旧以清华大学的Homebrew镜像源为例

1
2
3
4
5
6
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"
# 从镜像下载安装脚本并安装 Homebrew / Linuxbrew
git clone --depth=1 https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/install.git brew-install
/bin/bash brew-install/install.sh
rm -rf brew-install

验证是否安装成功

  • brew 命令本身及通过brew安装的所有命令都会被软链接到/usr/local/bin/下，所以需要将该路径加入系统环境PATH中

  • 重启终端，然后执行brew -v命令查看brew的版本，如果安装成功，会输出类似如下内容

1
2
$ brew -v
Homebrew 4.4.8-40-g13c3def

  • Homebrew本身的安装位置可以通过brew --repo查看，默认为/usr/local/Homebrew

  • 通过brew安装的软件包默认会被安装到/usr/local/Cellar/下，比如git安装后会在/usr/local/Cellar/git/目录下，可以通过brew info git查看安装信息，包括依赖库等。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# 显示 Homebrew 安装路径，macOS ARM: /opt/homebrew，macOS Intel: /usr/local
$ brew --prefix
/usr/local

# 显示 Homebrew 本地的 Git 仓库
$ brew --repo
/usr/local/Homebrew

# 显示 Homebrew Cellar 路径，命令行工具的安装路径
$ brew --cellar
/usr/local/Cellar

# 显示 Homebrew Caskroom 路径，GUI工具的安装路径
$ brew --caskroom
/usr/local/Caskroom

# 缓存路径，下载安装包的缓存路径，通过 brew cleanup 清理
$ brew --cache
~/Library/Caches/Homebrew

配置命令补全

1
2
autoload -Uz compinit
compinit

卸载brew

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

常用命令

  • brew支持安装命令行工具(formula)和GUI工具(cask)

    • brew install xxx 安装命令行工具，这个最为常用，比如 brew install fd
    • brew install --cask xxx 安装GUI工具，一般很少使用brew安装GUI工具，比如 brew install --cask firefox

  • brew的命令和参数非常多，但日常使用只需要记住常用的几个就够了，详细的命令列表可以参考Homebrew Documentation

1
2
3
4
# 查看brew支持哪些命令
brew commands
# 查看命令的帮助信息，比如
brew install --help

一些常用的命令

1
2
3
4
5
6
7
8
brew update # 更新brew到最新版本
brew --version # 查看brew的版本，可以简写为 brew -v
brew config # 查看brew的配置信息，这个命令很有用，可以查看到与brew相关的环境变量的值
brew home # 浏览器打开brew官网
brew home xxx # 浏览器打开xxx官网 如：打开fd命令的官网 brew home fd ,具体的名称可以通过brew list查看
brew cleanup # 清理缓存及日志文件，建议定期清理，当运行brew时会自动清理（2.0以后的版本）
brew cleanup -n # 显示将要清理的缓存及日志文件，只查看不删除
brew doctor # 检查是否有依赖问题，比如没有安装依赖库，或者依赖库版本过低，当运行brew报错时可以通过该命令进行检查并根据提示进行修改

  • 查看已安装的包

1
2
3
4
# 查看
brew list # 查看已安装的包
brew list --versions # 查看已安装的包及版本
brew info xxx # 查看xxx的安装信息

  • 安装、卸载

1
2
3
4
5
6
7
8
# 查找、安装、卸载
brew search xxx # 查找软件包，也可以通过 https://formulae.brew.sh 网页进行搜索
brew install xxx # 安装软件包，此命令相当于加上了 --formula ，安装时会自动下载依赖库，比如安装`nginx`时，会自动下载`openssl@3`和`pcre2`等
brew install --cask xxx # 安装GUI工具，比如`firefox`
brew uninstall xxx # 卸载软件包，此命令相当于加上了 --formula ，只会卸载当前包，不会卸载依赖库，这样就有可能存在很多冗余包
brew uninstall --cask xxx # 卸载GUI工具
brew autoremove # 删除所有仅作为另一个软件包的依赖项安装并且现在不再需要的包
brew autoremove --dry-run # --dry-run 仅查看哪些包可以删除，并不会真的删除

  • 升级

1
2
3
4
# 升级
brew outdated # 查看需要升级的包
brew upgrade xxx # 升级xxx到最新版
brew upgrade # 更新全部命令到最新版

  • 依赖关系

1
2
3
4
5
6
7
8
# 依赖关系
brew deps --tree xxx # 树形显示包的依赖树
brew deps --installed --tree # 树形显示所有安装包的依赖关系
brew deps --installed xxx # 显示当前安装包的依赖关系，纵向展示
brew deps --installed --for-each xxx # 显示当前安装包的依赖关系，横向展示
brew uses --installed xxx # 查看已经安装的哪些工具依赖当前包
brew leaves # 查看顶级安装包，即你通过brew直接安装的包，而不是通过安装其他软件包间接安装的
brew leaves | xargs brew deps --installed --for-each --formula # 查看顶级包，并列出每个顶级包的已安装依赖
1
2
3
4
5
6
7
8
9
10
11
# 仓库管理
brew tap # 查看所有已安装的仓库，tap安装路径 /usr/local/Homebrew/Library/Taps/
brew tap user/repo # 添加一个仓库，从gitthub下载
brew tap repo_url # 添加一个仓库，从给定的仓库地址下载
brew untap user/repo # 删除一个仓库

# 从第三方仓库安装工具，此时会自动将 homebrew-ffmpeg/ffmpeg 这个仓库添加到本地
brew install homebrew-ffmpeg/ffmpeg/ffmpeg

# 更新仓库，无论是brew自己的仓库还是第三方仓库，都会自动更新
brew update

  • brew services: brew的服务管理工具，可以方便的管理通过brew安装的服务，包括启动、停止、重启服务，等等，比如nginx、redis、mysql等，具体命令可以参考Homebrew Documentation

1
2
3
4
5
6
7
8
9
10
# 第一次执行 services 相关的命令时会自动下载 homebrew/services，也可以 通过 brew tap homebrew/services 提前下载
brew services list # 查看已安装的所有服务
brew services start nginx # 启动服务，并注册到系统启动服务列表，即创建系统自启动文件： ~/Library/LaunchAgents/homebrew.mxcl.nginx.plist
brew services stop nginx # 停止服务，并从系统启动服务列表中移除，即删除系统自启动文件
brew services kill nginx # 立即杀死服务，但不从系统启动服务列表中移除
brew services restart nginx # 重启服务
brew services info nginx # 查看服务的状态和进程IP
brew services run nginx # 运行服务，但不会保存到服务列表中
brew services cleanup # 清理无效的服务，即已卸载应用的无用的配置
brew services --help # 查看帮助

配置国内镜像源

  • 上面安装部分介绍了如何在安装brew时就指定镜像源，但有些时候因为我们在安装时忘记配置，或者原来的镜像源已经失效需要重新配置，此时可以按照下面的方法进行配置。

  • 此处以配置清华镜像源为例，阿里镜像源请参考阿里的官网文档–Homebrew镜像，科大源参考Homebrew

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
## 临时替换
# 配置brew国内镜像源
$ export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
# 配置brew-core国内镜像源
$ export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"
# 配置brew-bottle国内镜像源
$ 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"
# 更新配置
$ brew update

## 配置永久生效，zsh用户
# 配置brew国内镜像源
$ echo 'export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"' >> ~/.zshrc
# 配置brew-core国内镜像源
$ echo 'export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"' >> ~/.zshrc
# 配置brew-bottle国内镜像源
$ echo 'export HOMEBREW_API_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api"' >> ~/.zshrc
$ echo 'export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"' >> ~/.zshrc
$ source ~/.zshrc
# 更新配置
$ brew update

# 此时查看brew配置信息，可以看到已经生效了
$ brew config
HOMEBREW_VERSION: 4.4.8-38-g6089077
ORIGIN: https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
HEAD: 60890774e0a70fe93f94973b080068cf7b0d1c93
Last commit: 9 hours ago
Branch: master
Core tap origin: https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
Core tap HEAD: 787d1587bfa92794f7d141063a31773064ef9107
Core tap last commit: 11 minutes ago
Core tap JSON: 29 Nov 09:56 UTC
Core cask tap HEAD: 4c34bd8c418e13160fc79f1ca9312555d2edc254
Core cask tap last commit: 19 minutes ago
Core cask tap JSON: 29 Nov 09:56 UTC
HOMEBREW_PREFIX: /usr/local
HOMEBREW_API_DOMAIN: https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api
HOMEBREW_BOTTLE_DOMAIN: https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles
HOMEBREW_BREW_GIT_REMOTE: https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git
HOMEBREW_CASK_OPTS: []
HOMEBREW_CORE_GIT_REMOTE: https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git
HOMEBREW_GITHUB_API_TOKEN: set
HOMEBREW_MAKE_JOBS: 12
HOMEBREW_SORBET_RUNTIME: set
Homebrew Ruby: 3.3.6 => /usr/local/Homebrew/Library/Homebrew/vendor/portable-ruby/3.3.6/bin/ruby
CPU: dodeca-core 64-bit kabylake
Clang: 15.0.0 build 1500
Git: 2.43.0 => /usr/local/bin/git
Curl: 8.7.1 => /usr/bin/curl
macOS: 13.7.1-x86_64
CLT: 15.0.0.0.1.1694021235
Xcode: N/A

# 通过brew升级fd，可以看到使用了清华源
$ brew upgrade fd
==> Upgrading 1 outdated package:
fd 8.2.1 -> 10.2.0
==> Fetching fd
==> Downloading https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/fd-10.2.0.ventura.bottle.tar.gz
################################################################################################################################################################################### 100.0%
==> Verifying attestation for fd
==> Upgrading fd
  8.2.1 -> 10.2.0
==> Pouring fd-10.2.0.ventura.bottle.tar.gz
==> Caveats
zsh completions have been installed to:
  /usr/local/share/zsh/site-functions
==> Summary
🍺  /usr/local/Cellar/fd/10.2.0: 14 files, 2.9MB
==> Running `brew cleanup fd`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).
Removing: /usr/local/Cellar/fd/8.2.1... (13 files, 2.4MB)

  • 恢复为默认的GitHub镜像源

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
$ unset HOMEBREW_BREW_GIT_REMOTE
$ unset HOMEBREW_CORE_GIT_REMOTE
$ unset HOMEBREW_API_DOMAIN
$ unset HOMEBREW_BOTTLE_DOMAIN

# 如果您之前永久配置了 HOMEBREW 环境变量，还需要在对应的 ~/.bash_profile 或者 ~/.zshrc 配置文件中，将对应的 HOMEBREW 环境变量配置行删除
$ source ~/.zshrc

# 更新brew
$ git -C "$(brew --repo)" remote set-url origin https://github.com/Homebrew/brew
# 更新brew-core，brew4.0后不会再下载brew-core，所以可以忽略
# 不过从低版本升级上来的还会有这个仓库，可以通过 brew tap 查看是否存在，实际上改不改都不会有影响，看着不舒服就修改吧
$ git -C "$(brew --repo homebrew/core)" remote set-url origin https://github.com/Homebrew/homebrew-core
$ brew update

# 查看brew配置信息
$ brew config
HOMEBREW_VERSION: 4.4.8-38-g6089077
ORIGIN: https://github.com/Homebrew/brew
HEAD: 60890774e0a70fe93f94973b080068cf7b0d1c93
Last commit: 9 hours ago
Branch: master
Core tap HEAD: 787d1587bfa92794f7d141063a31773064ef9107
Core tap last commit: 13 minutes ago
Core tap JSON: 29 Nov 10:09 UTC
Core cask tap HEAD: 871fe2e8b93aac896a1808571ff11f8b89e6d90e
Core cask tap last commit: 48 seconds ago
Core cask tap JSON: 29 Nov 10:09 UTC
HOMEBREW_PREFIX: /usr/local
HOMEBREW_CASK_OPTS: []
HOMEBREW_GITHUB_API_TOKEN: set
HOMEBREW_MAKE_JOBS: 12
HOMEBREW_SORBET_RUNTIME: set
Homebrew Ruby: 3.3.6 => /usr/local/Homebrew/Library/Homebrew/vendor/portable-ruby/3.3.6/bin/ruby
CPU: dodeca-core 64-bit kabylake
Clang: 15.0.0 build 1500
Git: 2.43.0 => /usr/local/bin/git
Curl: 8.7.1 => /usr/bin/curl
macOS: 13.7.1-x86_64
CLT: 15.0.0.0.1.1694021235
Xcode: N/A

# 通过brew升级telnet，可以看到使用了GitHub源
$ brew upgrade telnet
==> Upgrading 1 outdated package:
telnet 294 -> 303.141.1
==> Downloading https://ghcr.io/v2/homebrew/core/telnet/manifests/303.141.1
################################################################################################################################################################################### 100.0%
==> Fetching telnet
==> Downloading https://ghcr.io/v2/homebrew/core/telnet/blobs/sha256:1be6b7b6a17a311fb3a2f1bffe7dae52284f3239b8af03f651c4fac11362f702
################################################################################################################################################################################### 100.0%
==> Verifying attestation for telnet
==> Upgrading telnet
  294 -> 303.141.1
==> Pouring telnet--303.141.1.ventura.bottle.tar.gz
🍺  /usr/local/Cellar/telnet/303.141.1: 5 files, 207.5KB
==> Running `brew cleanup telnet`...
Disable this behaviour by setting HOMEBREW_NO_INSTALL_CLEANUP.
Hide these hints with HOMEBREW_NO_ENV_HINTS (see `man brew`).
Removing: /usr/local/Cellar/telnet/294... (4 files, 208.2KB)

重要的说明

环境变量

  • brew安装的软件包会被软连接到/usr/local/bin/下，所以需要将该路径加入系统环境PATH中

  • 这里要注意一点，如果该路径在PATH中声明的比较靠前，就可能会被优先使用，比如我们已经手工在系统中安装了python的某个版本，但通过brew安装某些软件包时因为其依赖python，就会通过brew同时安装对应的python版本，此时我们在使用python命令时，就会优先使用这个

  • 有两种方法可以解决，1是通过brew unlink python来解除链接，此时并不是删除，而只是解除了软链，不会影响依赖它的工具的使用，如果需要恢复链接，可以通过brew link python来恢复链接；2是将我们的系统中自己安装的一些工具的路径声明在/usr/local/bin/之前，这样就不会有影响了。

Homebrew 4.0 带来的新变化

  • Homebrew 4.0 进行了一项最大的改动，组织方式从Git仓库管理改为JSON文件下载。

  • JSON文件会从formulae.brew.sh下载，而不再使用homebrew/core、homebrew/cask两个仓库，所以升级到4.0后，本地的homebrew/core、homebrew/cask 仓库都可以删除以释放磁盘空间。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 查看本地仓库
$ brew tap
homebrew/cask # cask 仓库，GUI的工具会从此下载，brew4.0后不再使用
homebrew/core # core 仓库，即 formula 仓库，命令行工具会从此下载，brew4.0后不再使用
homebrew/services # services 仓库，services 工具本身会从此下载，brew4.0后依旧使用

# 删除本地仓库
$ brew untap homebrew/core
$ brew untap homebrew/cask

# 此时再次执行 brew outdated 等命令时，会看到json文件被下载了，默认情况下，该json文件间隔24小时更新一次
$ brew outdated
==> Downloading https://formulae.brew.sh/api/formula.jws.json
##################################################################################### 100.0%
==> Downloading https://formulae.brew.sh/api/cask.jws.json
##################################################################################### 100.0%

  • 如果还想使用旧的仓库模式，只要配置下环境变量

1
echo 'export HOMEBREW_NO_INSTALL_FROM_API=1' >> ~/.zshrc

从镜像源的切换来理解brew下载安装包的过程

  • 前面我们介绍过，切换镜像源时要设置4个环境变量，那么为什么要设置这几个变量呢？它们的作用是什么呢，下面我就一个一个说明：

    • HOMEBREW_BREW_GIT_REMOTE

      • 设置brew仓库，用于更新brew命令本身，这个比较容易理解

    • HOMEBREW_CORE_GIT_REMOTE

      • 设置core仓库，用于更新formula的安装脚本
      • 当通过brew info xxx查看安装包信息时，可以看到From信息，这个就是命令的安装脚本，比如下面的fd.rb
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      $ brew info fd
      ==> fd: stable 10.2.0 (bottled), HEAD
      Simple, fast and user-friendly alternative to find
      https://github.com/sharkdp/fd
      Conflicts with:
        fdclone (because both install `fd` binaries)
      Installed
      /usr/local/Cellar/fd/10.2.0 (14 files, 2.9MB) *
        Poured from bottle using the formulae.brew.sh API on 2024-11-29 at 18:02:16
      From: https://github.com/Homebrew/homebrew-core/blob/HEAD/Formula/f/fd.rb
      License: Apache-2.0 OR MIT
      ==> Dependencies
      Build: rust ✘
      ==> Options
      --HEAD
        Install HEAD version
      ==> Caveats
      zsh completions have been installed to:
        /usr/local/share/zsh/site-functions
      ==> Analytics
      install: 6,327 (30 days), 24,518 (90 days), 116,476 (365 days)
      install-on-request: 6,326 (30 days), 24,515 (90 days), 116,363 (365 days)
      build-error: 0 (30 days)
      • 这个安装脚本中包含bottle do部分，其作用是当安装脚本时，优先从该部分获取对应的操作系统的二进制预编译包的sha256校验值，如果从对应的二进制源中找到，则直接从二进制预编译包的地址进行下载，该预编译下载地址由HOMEBREW_BOTTLE_DOMAIN指定，默认从官方源下载。
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      class Fd < Formula
        desc "Simple, fast and user-friendly alternative to find"
        homepage "https://github.com/sharkdp/fd"
        url "https://github.com/sharkdp/fd/archive/refs/tags/v10.2.0.tar.gz"
        sha256 "73329fe24c53f0ca47cd0939256ca5c4644742cb7c14cf4114c8c9871336d342"
        license any_of: ["Apache-2.0", "MIT"]
        head "https://github.com/sharkdp/fd.git", branch: "master"

        bottle do
          sha256 cellar: :any_skip_relocation, arm64_sequoia:  "9d17cfb029fbdc6ed31c732108f7aa746d3082dd4783ed35471ef79340615509"
          sha256 cellar: :any_skip_relocation, arm64_sonoma:   "82d5c2ffc2e2d0d8643a7c3f620c81ed49d7b23920aa23b6a7f4c50be69abc0b"
          sha256 cellar: :any_skip_relocation, arm64_ventura:  "354412ababb7d6c52abd9153ff96f133391406ce292b2122c76b96c2ab714f87"
          sha256 cellar: :any_skip_relocation, arm64_monterey: "0b41f292041767fd1c3c5b92daaa6c823fb07c1d7cd11b0427a415f08463f035"
          sha256 cellar: :any_skip_relocation, sonoma:         "4fa0fb4b3f512e45d35c569953efc7c59ebd8976caac9b2c1b1394b7e29157a0"
          sha256 cellar: :any_skip_relocation, ventura:        "b1406e5414252b1e1b90cfad188454eb31058256ed6246baed48c4e1cfe593a1"
          sha256 cellar: :any_skip_relocation, monterey:       "0ac060bf7d1529aa1f65e634f64b98b906df533d71f2185c883165c01f59ad53"
          sha256 cellar: :any_skip_relocation, x86_64_linux:   "2464fb21cc981166ffa9783fa14a09265790af4d89ce3a763421ddaf29119541"
        end

        depends_on "rust" => :build

        conflicts_with "fdclone", because: "both install `fd` binaries"

        def install
          system "cargo", "install", *std_cargo_args
          man1.install "doc/fd.1"
          generate_completions_from_executable(bin/"fd", "--gen-completions", shells: [:bash, :fish])
          zsh_completion.install "contrib/completion/_fd"
          # Bash completions are not compatible with Bash 3 so don't use v1 directory.
          # bash: complete: nosort: invalid option name
          # Issue ref: https://github.com/clap-rs/clap/issues/5190
          (share/"bash-completion/completions").install bash_completion.children
        end

        test do
          touch "foo_file"
          touch "test_file"
          assert_equal "test_file", shell_output("#{bin}/fd test").chomp
        end
      end
      • 注意，brew4.0后不再使用从该git仓库中获取安装脚本，因为formula的安装源代码已经全部存储在json文件中(见HOMEBREW_API_DOMAIN说明)，不再需要通过Git仓库下载
      • 切换镜像源时，brew4.0后不需要设置该环境变量

    • HOMEBREW_API_DOMAIN

      • 设置formula\cask的安装脚本下载源，默认https://formulae.brew.sh
      • brew4.0后不再从git仓库获取安装脚本，而是从这个json文件中一次性获取所有工具的安装脚本，默认24小时更新一次
      1
      2
      3
      4
      5
      6
      7
      官方源：
        formula源：https://formulae.brew.sh/api/formula.jws.json
        cask源：https://formulae.brew.sh/api/cask.jws.json

      清华源：
        formula源：https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api/formula.jws.json
        cask源：https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles/api/cask.jws.json
      • 如果还想使用旧的仓库模式，只要配置下环境变量，这样即使你升级后已经删除了对应的仓库，它也会在第一次使用到时自动下载
      1
      2
      # 官方也提到，非开发人员没必要这样做
      echo 'export HOMEBREW_NO_INSTALL_FROM_API=1' >> ~/.zshrc

    • HOMEBREW_BOTTLE_DOMAIN

      • 指定预编译二进制包（也称为 bottles）的下载地址，Homebrew 使用这些 bottles 来加速软件安装过程，避免在每个用户的计算机上都重新从源代码构建软件。
      • 当我们通过brew install xxx安装软件时，brew会先从该formula的安装脚本（4.0以前从HOMEBREW_CORE_GIT_REMOTE指定的git仓库获取，4.0以后从HOMEBREW_API_DOMAIN指定的json文件中获取）中获取该软件的安装信息，然后根据安装信息从bottle中下载对应的预编译二进制包，再将其安装到本地。
      • 下载后的二进制包会被保存到缓存目录中(brew --cache)，安装后的软件包存储到Cellar目录中(brew --cellar)

  • 通过上面的分析，我们可以得出结论，切换镜像源时，实际上只需要设置3个变量就够了

1
2
3
HOMEBREW_BREW_GIT_REMOTE
HOMEBREW_API_DOMAIN
HOMEBREW_BOTTLE_DOMAIN