1. 从“包管理器”说起为什么我们需要 Homebrew如果你是一名 macOS 或 Linux 用户并且尝试过在终端里安装一个软件比如wget或者node你很可能经历过这样的场景打开浏览器搜索“如何在 Mac 上安装 wget”然后点开某个教程它告诉你需要先运行一串长长的curl命令或者去某个官网下载.pkg文件又或者更复杂需要先安装 Xcode 命令行工具。整个过程繁琐、割裂而且你永远不知道下载的安装包是否安全、是否是最新版本、卸载时会不会留下各种垃圾文件。这种体验与我们在手机上通过 App Store 一键安装应用的便捷性形成了鲜明对比。Homebrew 的出现就是为了解决这个核心痛点。它本质上是一个包管理器。你可以把它想象成 macOS 和 Linux 上的“软件商店命令行版本”但它比图形化的商店更强大、更自由。它的设计哲学是“缺什么装什么”并且自动帮你处理好软件之间的依赖关系。比如你要安装一个图像处理工具imagemagick它可能依赖libpng、libjpeg等一堆库。在传统方式下你需要手动一个个找、一个个装版本冲突能让你头疼一整天。而 Homebrew 会分析这个“配方”在 Homebrew 里叫Formula自动下载、编译或下载预编译好的二进制包并安装所有必需的依赖最后把软件链接到系统标准路径让你在终端里直接输入命令就能使用。我用了 Homebrew 超过八年从最初只是为了方便装个tree命令查看目录结构到现在用它管理着上百个开发工具、命令行应用和桌面软件。它彻底改变了我在 macOS 上的工作流让环境配置从一件令人畏惧的琐事变成了几分钟就能搞定的例行公事。这篇文章我就从一个重度用户的角度带你从零开始彻底搞懂 Homebrew 的安装、核心使用心法以及那些官方文档里不会写的“坑”和高级技巧。2. 基石铺设手把手完成 Homebrew 的安装与初始化安装 Homebrew 本身是一个简单的过程但理解其背后的原理和完成安装后的初始化设置才是确保未来使用顺畅的关键。很多人卡在安装第一步或者装完后命令不生效问题往往出在细节上。2.1 理解安装脚本它到底在做什么Homebrew 的官方安装命令非常简洁/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)这行命令做了以下几件事curl -fsSL-f表示失败时静默-s静默模式不显示进度条-S在静默模式下显示错误-L跟随重定向。组合起来就是以安静、可靠的方式获取安装脚本。/bin/bash -c将下载的脚本内容直接传递给 Bash 解释器执行。这里有一个至关重要的细节这个安装脚本会检查你的系统环境。对于搭载 Apple SiliconM1/M2/M3 等芯片的 Mac它会优先将 Homebrew 安装到/opt/homebrew目录。而对于 Intel 芯片的 Mac则安装到传统的/usr/local/Homebrew。这是为了兼容 ARM 架构和避免污染系统根目录。安装过程会自动创建这个目录并将 Homebrew 的核心文件Git 仓库克隆到其中。2.2 安装后的关键一步配置 Shell 环境变量安装脚本运行到最后通常会输出两行重要的提示类似于 Next steps: - Run these two commands in your terminal to add Homebrew to your PATH: echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zshrc source ~/.zshrc这是整个安装过程中最容易出错、也是最关键的一步。它的目的是将 Homebrew 的可执行文件路径/opt/homebrew/bin和/opt/homebrew/sbin添加到你的系统PATH环境变量中。PATH相当于系统寻找命令的“地址簿”只有地址簿里有的路径你输入brew命令时系统才知道去哪里找这个程序。如果你使用的是 macOS Catalina (10.15) 及之后的版本默认的 Shell 是zsh配置文件是~/.zshrc。如果你使用的是更早的系统或者手动切换过 Shell可能是bash配置文件是~/.bash_profile或~/.bashrc。你必须根据自己使用的 Shell将正确的命令写入对应的配置文件。直接复制安装脚本输出的命令即可。写入后执行source ~/.zshrc或对应的文件让配置立即生效或者直接新开一个终端窗口。验证安装是否成功运行brew --version。如果能看到 Homebrew 的版本号说明安装和 PATH 配置都正确了。如果提示command not found: brew百分之百是环境变量没配好请回头检查。2.3 安装 Xcode 命令行工具绕不开的依赖在安装 Homebrew 之前或之后系统可能会提示你安装“Xcode Command Line Tools”。这是一套包含编译器如clang、链接器、Git 等基础开发工具的集合。Homebrew 在安装某些需要从源代码编译的软件时必须依赖这些工具。你可以手动触发安装xcode-select --install在弹出的图形界面中点击“安装”即可。安装完成后可以通过xcode-select -p查看路径来验证。注意即使你不需要做 iOS 开发也强烈建议安装这个命令行工具。它是很多开源软件编译的基础提前装好能避免后续无数奇怪的报错。3. 核心操作指南像高手一样使用brew命令掌握了安装我们就进入了日常使用的阶段。Homebrew 的命令设计非常直观遵循brew 子命令 [选项] [软件名]的模式。下面我按使用频率和重要性拆解几个最核心的子命令。3.1 软件管理三板斧安装、更新、卸载安装 (install)这是最常用的命令。brew install wgetHomebrew 会从它的核心仓库Homebrew/core中找到wget的 Formula下载预编译的“瓶子”Bottle即二进制包进行安装。如果某个软件没有预编译的瓶子它会自动下载源代码在你的本地进行编译这通常会更耗时。搜索 (search)在安装前如果你不确定软件包的确切名称可以用search。brew search python这会列出所有名称或描述中包含“python”的 Formula比如python3.11,python3.12等。你可以从中选择你需要的具体版本。更新 (update upgrade)保持软件最新是安全性和稳定性的重要一环。Homebrew 的更新分为两步brew update更新 Homebrew 自身。这个命令会拉取 Homebrew 的核心仓库Git的最新数据获取所有 Formula 的最新版本信息。它不更新任何已安装的软件。你应该定期比如每天或每周运行此命令。brew upgrade更新所有已安装的软件。在执行upgrade之前必须先运行update否则 Homebrew 不知道有哪些新版本可用。你也可以指定单个软件进行更新brew upgrade wget。一个常见的习惯是组合使用brew update brew upgrade。表示前一个命令成功后才执行后一个。卸载 (uninstall / remove)brew uninstall wget # 或 brew remove wget这两个命令等价。Homebrew 会卸载该软件并尝试移除其不再被依赖的库。但有时为了保守起见它不会自动删除某些可能被其他软件共享的依赖。如果你想更彻底地清理需要用到autoremove。3.2 高级维护清理与诊断随着使用Homebrew 会下载大量的“瓶子”缓存文件和旧版本软件占用磁盘空间。以下命令用于系统维护brew cleanup清理旧版本的安装文件和下载缓存。这是最常用的清理命令。你可以加-n参数先预览将要清理的内容brew cleanup -n。brew autoremove卸载那些没有被任何已安装软件依赖的“孤儿”Formula。比如你装了 AA 依赖 B 和 C。后来你卸载了 A但 B 和 C 可能还留着。这个命令就是用来清理 B 和 C 的。brew doctor你的“家庭医生”。当遇到任何奇怪的问题如安装失败、链接错误时首先运行这个命令。它会检查你的 Homebrew 安装是否存在常见问题并给出修复建议。输出可能很长但请仔细阅读它指出的Warning往往是问题的根源。brew list列出所有通过 Homebrew 安装的软件。brew info formula查看某个软件的详细信息包括版本、依赖、安装选项等。在安装前查看info是个好习惯。4. 超越基础掌握 Cask、Services 和 Tap 的进阶玩法如果你认为 Homebrew 只能管理命令行工具那就太小看它了。它的两个扩展功能Cask和Services以及仓库扩展机制Tap才是其真正强大的地方。4.1 Homebrew Cask管理图形界面应用这是 Homebrew 生态中革命性的部分。通过 Cask你可以用命令行安装、更新和管理如 Chrome、Visual Studio Code、Spotify 这样的图形化 macOS 应用程序。brew install --cask google-chrome注意这里的--cask参数。它会从 Homebrew 的另一个专门仓库homebrew/cask中获取“Cask”可以理解为图形应用的 Formula然后将.dmg或.pkg文件下载、解压并将应用拖到/Applications文件夹就像你手动做的一样但全自动。管理方式与命令行软件一致更新所有 Cask 应用brew upgrade --cask查看已安装的 Caskbrew list --cask卸载 Cask 应用brew uninstall --cask google-chrome一个我常用的技巧在新电脑上配置开发环境时我会用一个脚本批量安装所有需要的开发工具和常用软件其中就大量使用brew install和brew install --cask半小时内就能重建一个熟悉的生产力环境。4.2 Homebrew Services管理后台服务许多软件如数据库PostgreSQL, Redis、Web 服务器Nginx是作为后台服务守护进程运行的。Homebrew Services 子命令提供了统一的方式来管理这些服务的生命周期。brew install postgresql brew services start postgresql # 启动 PostgreSQL 服务 brew services stop postgresql # 停止服务 brew services restart postgresql # 重启服务 brew services list # 查看所有由 Homebrew 管理的服务及其状态这比手动记忆不同的启动命令pg_ctl,redis-server要方便和一致得多。它利用 macOS 的launchctl来管理服务确保开机自启。4.3 Tap扩展你的软件仓库Homebrew 默认只从官方核心仓库homebrew/core和homebrew/cask安装软件。但世界上有无数优秀的软件不在官方仓库里。这时就需要Tap。 “Tap”在英文中是“水龙头”的意思在这里形象地比喻为“接入”一个新的软件源。brew tap user/repo例如早年 Docker 的桌面版就维护在一个独立的 Tap 里brew tap homebrew/cask-versions用于安装软件的历史版本。添加 Tap 后你就可以像安装官方软件一样安装其中的软件了。使用建议只添加你信任的、活跃维护的 Tap。每个 Tap 都是一个独立的 Git 仓库。查看已添加的 Tapbrew tap移除一个 Tapbrew untap user/repo5. 实战避坑与效能优化那些只有老用户才知道的事经过多年的使用我踩过不少坑也总结了一些能极大提升体验的技巧。这部分内容你在官方文档里很难看到这么集中的总结。5.1 国内用户的核心痛点镜像源加速由于网络原因从 GitHub 克隆 Homebrew 仓库或下载“瓶子”的速度可能非常慢甚至失败。为 Homebrew 更换国内镜像源是必做操作。通常需要更换两个部分的源Homebrew 核心仓库地址即brew命令本身更新时拉取 Formula 的 Git 仓库。Bottle 二进制预编译包的下载地址。以清华大学开源软件镜像站为例更换命令如下请务必先查看镜像站官网的最新说明因为路径可能会变# 替换 brew 程序本身的 git 仓库源 cd $(brew --repo) git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git # 替换 Homebrew Core 源 cd $(brew --repo)/Library/Taps/homebrew/homebrew-core git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git # 替换 Homebrew Cask 源 cd $(brew --repo)/Library/Taps/homebrew/homebrew-cask git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-cask.git # 对于 Apple Silicon Mac还需要设置环境变量指向镜像站的 bottles echo export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles ~/.zshrc source ~/.zshrc完成上述操作后运行brew update感受飞一般的速度。如果未来想换回官方源只需将上述 URL 替换回https://github.com/Homebrew/开头的地址即可。5.2 多版本软件共存与切换有时我们需要在同一个系统上安装同一个软件的多个主要版本例如 Python 3.11 和 3.12。Homebrew 对此有很好的支持但需要遵循特定的命名规则。对于官方支持多版本的软件如python,nodeFormula 的名称会带有版本号例如python3.11。brew install python3.11 brew install python3.12安装后它们的可执行文件会被命名为python3.11和python3.12以避免冲突。默认的python3或python命令可能链接到其中一个具体取决于其他依赖。你可以使用brew link命令来手动创建链接但更推荐使用brew info python3.11查看输出中的提示它通常会告诉你怎么设置 PATH 来优先使用某个版本。对于更复杂的管理社区有像brew install pyenv这样的专门版本管理工具它们与 Homebrew 结合使用效果更佳。5.3 安装失败排查黄金步骤当你遇到brew install失败时不要慌张按以下步骤排查99%的问题都能解决首先运行brew doctor严格遵循其给出的Warning建议进行修复。常见问题包括PATH 配置错误、Xcode 命令行工具不完整、权限问题等。更新 Homebrew运行brew update确保 Formula 信息是最新的。一个过时的仓库信息可能导致它尝试下载一个已经不存在的文件。清理缓存运行brew cleanup有时陈旧的下载缓存会导致哈希校验失败。查看详细错误信息安装命令加上-vverbose参数如brew install -v formula。这会打印出详细的编译或下载日志错误信息往往就藏在其中。把最后几十行日志复制到搜索引擎里通常能找到答案。检查依赖运行brew deps --tree formula查看该软件的所有依赖也许某个底层依赖安装失败了。查阅 Issue去 Homebrew 的 GitHub 仓库homebrew/core或homebrew/cask搜索相关 Formula 的 Issue很可能别人已经遇到并解决了同样的问题。5.4 自定义安装选项与编译参数有些 Formula 提供了安装选项。你可以通过brew info formula查看。例如安装vim时可能想启用 Python3 支持brew install vim --with-python3但请注意使用自定义选项意味着 Homebrew 无法使用预编译的“瓶子”必须从源代码编译这会耗费更多时间并且你需要确保所有编译依赖都已就位。对于更高级的用户如果你需要传递特定的编译参数如CFLAGS,LDFLAGS可以在安装前设置环境变量export LDFLAGS-L/usr/local/opt/openssl/lib export CPPFLAGS-I/usr/local/opt/openssl/include brew install formula6. 将 Homebrew 融入自动化工作流Homebrew 的真正威力在于其可脚本化和可重复性。这里分享两个我日常使用的自动化模式。6.1 创建你的“环境清单”文件创建一个名为Brewfile的文本文件名字是惯例在里面列出所有你需要的软件。格式很简单# Brewfile tap homebrew/cask-versions # 添加 Tap # 命令行工具 brew wget brew tree brew git brew node brew python3.12 # 图形应用 (Cask) cask google-chrome cask visual-studio-code cask iterm2 cask notion # 启动服务 brew postgresql, restart_service: true brew redis, restart_service: true然后在新系统或新用户环境下只需执行一条命令即可自动安装所有清单中的软件brew bundle --file~/path/to/Brewfile # 或者如果文件就在当前目录且名为 Brewfile brew bundle你还可以用brew bundle dump命令自动生成当前系统所有通过 Homebrew 安装的软件列表非常方便备份和同步环境。6.2 与配置管理工具结合如果你使用 Ansible、Chef、Puppet 等配置管理工具或者简单的 Shell 脚本可以将brew命令集成进去实现开发环境的完全自动化配置。例如一个简单的 Ansible 任务- name: Install Homebrew shell: /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh) args: creates: /opt/homebrew/bin/brew # 如果文件已存在则不执行 - name: Add Homebrew to PATH lineinfile: path: ~/.zshrc line: eval $(/opt/homebrew/bin/brew shellenv) state: present - name: Install common packages homebrew: name: {{ item }} state: present loop: - git - wget - python3.12通过这种方式无论是个人电脑的重装还是团队新成员入职都能快速获得一套统一、可控的开发环境。回顾这些年Homebrew 早已从一个单纯的工具变成了我 macOS 系统不可或缺的“基础设施”。它带来的不仅仅是安装软件的便利更重要的是一种秩序和掌控感。你不再需要记住各种软件的官网不再需要处理复杂的依赖也不再担心卸载残留。所有的操作都通过brew这个统一的接口完成干净、透明、可追溯。最后分享一个我个人的小习惯我每周一会打开终端习惯性地输入brew update brew upgrade brew cleanup就像给系统做一次简单的“晨间整理”。看着那些软件包一个个更新到最新版本心里会有一丝莫名的踏实感。或许这就是工具带来的最高境界——它如此可靠地融入你的工作流以至于你几乎感觉不到它的存在却又无处不在。