如何在 Mac 上安装 Homebrew

Kalyn

Homebrew 是 macOS 上最受欢迎的软件包管理器,可以轻松安装和管理 Mac 中未附带的软件工具。如果您正在设置一台新机器或开始开发工作,Homebrew 可以简化您所需工具的安装过程。Homebrew 将软件包安装到它们自己的目录中,然后创建符号链接以使其可访问,从而使您免于手动安装的麻烦。

Homebrew 的安装过程已于 2025 年得到简化,只需几个终端命令即可启动和运行。在安装 Homebrew 之前,您需要检查 macOS 版本并确保系统上安装了 Xcode 命令行工具。使用 Apple Silicon 芯片(M1、M2 或 M3)的 Mac 用户在安装后需要遵循略有不同的步骤来配置其 shell。

安装后,Homebrew 将成为您通过“brew install”等简单命令访问数千个有用软件包和应用程序的门户。对于想要自定义 Mac 体验(超越 Apple 提供的开箱即用功能)的开发人员、设计师和高级用户来说,此工具已变得至关重要。

Homebrew 是 macOS 事实上的包管理器,使您能够轻松安装和管理数千个开源工具、库和应用程序。无论您是开发人员、系统管理员还是高级用户,Homebrew 都可以极大地扩展您的 Mac 的功能。到 2025 年,Homebrew 仍然至关重要,并且由于对 Apple Silicon(M1、M2、M3)以及最新 macOS 版本(如 Sonoma 和 Sequoia)的本机支持,安装它比以往任何时候都更容易。

让我们逐步介绍您需要了解的所有内容 — 从先决条件到安装、shell 设置、故障排除和高级用法。


安装 Homebrew 之前的先决条件

在开始之前,请确保您的 Mac 已准备就绪:

  • macOS 文图拉 (13)或稍后推荐。与 macOS Sonoma 和 Sequoia 无缝协作 (15)。
  • 64 位 Intel 或 Apple Silicon 处理器(M1、M2、M3)。
  • 管理员权限(系统会要求您输入 Mac 密码)。
  • Xcode 命令行工具— 编译和运行大多数包所需。

💡提示:如果您不确定是否安装了命令行工具,请运行xcode-select -p在终端中。如果没有返回任何内容,则您需要安装它们。


一步步自制安装

1.安装Xcode命令行工具

打开终端(应用程序 > 实用程序),然后运行:

xcode-select --install

接受提示开始安装。这将安装许多 Homebrew 软件包所需的基本开发人员工具和编译器。


2.安装Homebrew本身

安装 Xcode 工具后,运行 Homebrew 安装脚本:

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

系统将提示您输入管理员密码。 Homebrew 将安装到:

  • /opt/homebrew苹果硅麦克斯
  • /usr/local基于英特尔麦克斯

🛡️ 该脚本执行系统检查,并在缺少任何内容时建议后续配置。在继续之前让它完全完成。


3. 将 Homebrew 添加到您的 Shell 配置文件中(Apple Silicon Mac)

如果您使用的是 M1/M2/M3 Mac,除非您配置 shell 环境,否则 Homebrew 可能无法立即在终端中可用。跑步:

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

这确保每个新的终端会话都能识别brew自动命令。


4. 测试您的安装

为了确保一切正常:

brew doctor

如果您看到:

Your system is ready to brew.

你已经准备好了。


可选:关闭自制分析

Homebrew 跟踪匿名使用统计数据。如果您不想参与,请运行:

brew analytics off

您可以稍后随时将其重新打开brew analytics on


如何使用自制程序

以下是您经常使用的基本命令:

安装包

brew install <package_name>

例子:

brew install wget

更新自制程序

brew update

这将刷新可用软件包及其最新版本的列表。

升级已安装的软件包

brew upgrade

这会将之前安装的所有配方和桶更新为最新版本。

卸载包

brew uninstall <package_name>

如何卸载自制程序

如果您想完全删除 Homebrew:

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

该脚本将引导您从系统中删除 Homebrew 文件和目录。


专业提示

  • 安装 GUI 应用程序与自制桶:brew install --cask google-chrome
  • 搜索包:brew search <keyword>
  • 查看有关包的信息:brew info <package_name>
  • 修复权限或问题: 跑步brew doctor经常

为什么开发人员和高级用户喜欢 Homebrew

Homebrew 将 Linux 风格的包管理引入 macOS。它填补了苹果为高级用户留下的空白,提供对数千种命令行工具、编程语言、库甚至桌面应用程序的简单访问。

它得到积极维护,得到社区支持,并与自动化工具、CI/CD 工作流程以及 Docker、Git 和 Python 等开发人员环境集成。


设置 Homebrew 后,您的 Mac 将成为一台功能更强大、可定制且对开发人员友好的机器 - 一次执行一个命令。

要点

  • Homebrew 通过终端使用简单的命令管理软件包,从而简化了 Mac 上的软件安装。
  • 在安装之前,用户需要更新 macOS 并安装 Xcode 命令行工具才能正常使用。
  • Apple Silicon Mac 用户 (M1/M2/M3) 在基本 Homebrew 安装后需要额外的 shell 配置步骤。

准备 Mac 进行 Homebrew 安装

在 Mac 上安装 Homebrew 之前,您需要使用一些基本组件准备系统。这些准备工作确保了安装过程的顺利进行以及安装后 Homebrew 的正常运行。

验证 macOS 兼容性

Homebrew 适用于 macOS 10.14 (Mojave) 或更高版本,包括最新版本macOS 版本。截至 2025 年 3 月,所有最新的 Mac 系统都应该兼容,但检查您的版本仍然很重要。

要检查您的 macOS 版本,请单击左上角的 Apple 菜单,然后选择关于本机。版本号将突出显示在打开的窗口中。

使用 Apple Silicon(M1、M2 或更新的芯片)的 Mac 用户需要注意,Homebrew 安装到与 Intel Mac(/usr/local)不同的位置(/opt/homebrew)。这种区别是在安装过程中自动处理的。

如果您运行的是旧版本的 macOS,请考虑在安装 Homebrew 之前进行升级,以避免与较新的软件包出现兼容性问题。

安装 Xcode 命令行工具

Xcode 的命令行工具是 Homebrew 的重要依赖项。这些工具提供了编译器等必要的开发组件,无需完整安装 Xcode。

要安装命令行工具:

  1. 打开终端(可在“应用程序”>“实用程序”中找到)
  2. 运行这个命令:xcode-select --install
  3. 点击安装在出现的提示上
  4. 等待下载安装完成(一般5-15分钟)

您可以通过运行以下命令来验证安装是否成功:

xcode-select -p

这应该返回类似的路径/Library/Developer/CommandLineTools。如果您遇到任何问题,可以直接从以下地址下载工具苹果开发者网站

设置终端环境

终端应用程序是您与 Homebrew 交互的地方。 macOS 附带的终端预安装在“应用程序”>“实用工具”文件夹中。

现代 Mac 使用桀骜作为默认 shell,而旧系统可能会使用巴什。您可以通过运行以下命令来检查当前的 shell:

echo $SHELL

Homebrew 会自动更新你的 shell 配置文件(比如.zprofile对于 zsh 或.bash_profile对于 bash)在安装过程中将 Homebrew 添加到您的 PATH 中。

为了获得最佳体验,请考虑:

  • 熟悉基本的终端命令
  • 确保您的用户帐户具有管理权限
  • 安装 Homebrew 以应用 PATH 更改后关闭并重新打开终端

如果您喜欢功能更丰富的终端体验,iTerm2 等替代品可以与 Homebrew 完美配合并提供附加功能。

执行自制安装

在 Mac 上安装 Homebrew 需要运行特定命令并执行一些设置步骤。安装后,您可以使用这个强大的包管理器来安装和管理各种软件包,而无需手动下载和配置的麻烦。

使用自制安装命令

要在 Mac 上安装 Homebrew,请打开终端并运行以下命令:

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

此命令下载并执行 Homebrew 安装脚本。该脚本使用curl获取安装文件-fsSL标志确保安静且可靠的下载。

对于 Apple Silicon Mac(M1、M2 等),Homebrew 安装到/opt/homebrew,而英特尔 Mac 使用/usr/local。安装程序将要求您输入密码以设置必要的权限。

在运行安装之前,请确保已安装 Xcode 命令行工具。如果没有,请运行:

xcode-select --install

执行安装后检查和设置

安装完成后,运行brew doctor检查潜在问题。此命令会验证您的 Homebrew 安装并针对发现的任何问题提出修复建议。

brew doctor

对于 Apple Silicon Mac,将 Homebrew 添加到您的 PATH 中,方法是将这些行添加到您的~/.zprofile:

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

跑步brew update以确保您拥有最新的包定义。此命令将本地 Homebrew 与远程存储库同步,使您可以访问最新的软件包。

Homebrew 默认收集匿名分析。要禁用此功能,请运行:

brew analytics off

管理自制程序包

设置 Homebrew 后,安装软件包就变得简单了。使用brew install后面是包名:

brew install wget
brew install python
brew install gcc

热门套餐包括imagemagick对于图像处理,rsync用于文件传输,以及gnuplot用于数据可视化。对于具有图形界面的应用程序,请使用:

brew install --cask docker

要删除包,请使用brew uninstall或者brew remove:

brew uninstall protobuf

使用以下命令查看所有已安装的软件包:

brew list

要更新已安装的软件包,请运行:

brew upgrade

如果出现问题,请使用brew doctor诊断问题或查看 Homebrew 文档故障排除提示

常见问题解答

Mac 系统上的自制软件安装可能会带来独特的挑战,具体取决于您的硬件和软件配置。以下是用户在设置和故障排除过程中遇到的一些常见问题的解答。

在配备 M1 芯片的 Mac 上安装 Homebrew 的步骤是什么?

在上安装 HomebrewM1 Mac需要一些具体步骤。用户应首先打开终端并运行 Homebrew 网站上的官方安装命令。

安装过程中系统可能会提示输入管理员密码。安装完成后,用户需要通过更新 shell 配置文件将 Homebrew 添加到他们的 PATH 中。

M1 Mac 用户可能需要在某些命令前加上前缀arch -arm64确保软件在 Apple Silicon 上本地运行,而不是通过 Rosetta 翻译运行。

尝试安装 Homebrew 后如何解决“zsh:找不到命令:brew”错误?

当安装了 Homebrew 但未正确添加到 PATH 环境变量时,通常会出现此错误。解决方案是将Homebrew添加到shell配置文件中的PATH中。

对于 zsh 用户,编辑.zshrc在主目录中添加以下文件:export PATH="/opt/homebrew/bin:$PATH"对于 M1 Mac 或export PATH="/usr/local/bin:$PATH"适用于英特尔 Mac。

保存文件后,运行source ~/.zshrc无需重新启动终端即可应用更改。

当我在 Mac 上遇到“未找到 Brew 命令”错误时,我该怎么办?

首先,通过检查 Homebrew 目录来验证 Homebrew 是否实际安装。在 Intel Mac 上,查看/usr/local/,并在 M1 Mac 上检查/opt/homebrew/

如果安装了 Homebrew 但未找到该命令,则问题可能与 PATH 配置有关。如上一个答案中所述更新 shell 配置文件。

有时重新安装 Homebrew 可以完全解决持续存在的问题。先运行卸载脚本,然后使用官方安装命令重新安装。

如何在 Mac 上使用 Homebrew 安装 Git 或 Python 等软件包?

使用 Homebrew 安装软件包非常简单。打开终端并使用命令brew install后面跟包名,例如brew install git或者brew install python

在安装之前,最好先运行一下brew update确保 Homebrew 拥有最新的软件包信息。这有助于避免兼容性问题。

要查看可用的软件包,请使用brew search后面跟着一个关键字。例如,brew search python将显示所有与Python相关的包。

在哪里可以找到官方 Homebrew 文档或其 GitHub 存储库以进行故障排除?

官方 Homebrew 文档位于https://docs.brew.sh,其中包含全面的指南、常见问题解答和故障排除信息。

Homebrew 的 GitHub 存储库可以在以下位置找到:https://github.com/Homebrew/brew,用户可以在其中查看未解决的问题或在遇到错误时提交新问题。

Homebrew 社区在讨论论坛和 Stack Overflow 等平台上也很活跃,通常会解决特定的安装或使用问题。

“brew”和 Homebrew 之间的差异如何影响 Mac 上的软件包安装?

“brew”只是 Homebrew 的命令行界面,而不是一个单独的工具。任何对差异的提及都可能是对术语的误解。

当用户输入brew install在终端中,他们使用 Homebrew 包管理器来安装软件。如果 Homebrew 没有正确安装,brew 命令将不起作用。

有时,用户可能会将 Homebrew 与其他包管理器(例如 MacPorts 或 Fink)混淆,它们是工作方式不同并维护单独包存储库的替代系统。