简介Homebrew 是苹果 macOS 系统上一款广受欢迎的开源软件包管理工具这份资源围绕其安装、配置与日常运维提供系统性讲解旨在帮助开发者摆脱手动编译和依赖管理的繁琐通过简洁命令完成软件包的搜索、安装、升级与卸载。内容涵盖 brew search、list、update、upgrade、uninstall 等常用命令以及 Homebrew Cask 管理图形界面应用、自定义 tap 扩展非官方软件源、brew doctor 健康检查与 cleanup 清理旧版本等核心功能并深入说明 Cellar、Library、bin 等目录结构与工作流程同时提供面对更新冲突、依赖异常等常见问题的排错思路。资源按功能模块组织既适合刚接触苹果开发环境的新手逐步上手也可作为中高级开发者日常维护效率手册。资源共 2000 个文件以 Ruby 脚本rb为主辅以 Markdown 文档、YAML 配置、JSON 数据及示例文件分别承担核心逻辑、使用说明、配置模板与演示功能压缩包整体约 421.56 兆字节。目前已有超过 2.1 万人学习下载实用性与社区认可度高通过本资源可系统掌握 Homebrew 的软件管理方法显著提升在苹果系统下的开发与运维效率。 老Mac用户应该都有过这种经历想装个wget、node或者ffmpeg去官网一看要让源码编译依赖一个接一个半天都装不完直接下载dmg安装包吧遇到升级版本的时候又得重新手动下载一次。我第一次折腾Ruby环境的时候就是在源码编译上浪费了一下午后来同事甩过来一句“你别手动折腾了用Homebrew装”我才开始接触这个macOS上的软件管理工具。Homebrew是一款面向macOS和Linux系统的软件包管理器通俗点说它就是macOS的“应用商店”只不过它管的不是图形界面的App而是数万个开发者需要用到的命令行工具、运行环境和基础库。装了它之后安装软件只需要敲一行命令升级、卸载、管理依赖也都是自动化处理不用再跟编译参数、动态链接库搏斗。这篇文章我会从核心概念、安装配置、日常操作到常见报错排查把我自己这几年折腾Homebrew的经验完整写一遍希望对刚入坑Mac或者刚接触命令行的读者有帮助。1. 项目概述Homebrew到底解决什么问题1.1 一个包管理器为什么这么重要先说说没有包管理器的时候在macOS上装一个开发工具是什么体验。以安装nginx为例你需要先去官网下载源码包然后自己解决PCRE、zlib、OpenSSL这些依赖库每一个库都可能因为版本问题跟你闹脾气configure阶段报错、编译阶段报错、链接阶段报错光是排错就能耗掉半天。更麻烦的是以后想升级nginx你还得把这些流程重新走一遍。有了Homebrew之后就完全不一样了。它背后有一个庞大的社区维护的Formula仓库把每个软件的下载地址、依赖关系、编译参数都提前定义好了。你执行一条brew install nginx它会自动把依赖处理、下载、编译、目录安装、环境变量配置全搞定整个过程是可控的、可重复的、可回滚的。这也解释了Homebrew名字的由来brew是酿造的意思它把软件的“配方”叫Formula软件的安装目录叫Cellar酒窖装好的程序像一瓶瓶酒一样整齐码在酒窖里。这种设计理念贯穿始终——一切管理都有章法安装和卸载都干干净净。1.2 Homebrew、MacPorts、手动编译怎么选在macOS生态里除了Homebrew还有MacPorts和老牌的手动编译安装。我当年也纠结过都试过一轮后一直用到了今天的还是Homebrew。MacPorts更像FreeBSD的ports体系依赖库统一安装在/opt/local下规则很严格但编译速度偏慢很多包需要从源码构建而且占用空间比较大。手动编译适合需要对编译参数做非常定制化调整的场景比如你要针对特定CPU架构做优化但日常使用完全没必要付出这么高的时间成本。Homebrew在“开箱即用”和“可控性”之间取了一个很好的平衡。它默认用预编译好的二进制包也就是bottle安装速度很快同时如果你想改编译参数也可以直接编辑Formula定制安装。简单说绝大多数人日常使用选Homebrew就够了不用折腾。2. Homebrew核心设计思路与目录结构解析2.1 四个关键目录Cellar、Caskroom、bin、opt要真正用好Homebrew我建议先理解它在磁盘上是怎么组织文件的。Homebrew安装后会在主目录下创建几个核心目录我用一个表格说明它们的分工目录作用位置说明Cellar软件本体实际安装的地方每个软件按版本路径存放/usr/local/CellarIntel或/opt/homebrew/CellarApple SiliconCaskroom存放通过brew install --cask安装的图形化App包同前缀下的Caskroom目录bin存放命令行工具的软链接指向Cellar里的真实可执行文件/usr/local/bin或/opt/homebrew/binopt存放需要被引用/关联的旧版本或不带前缀的软件路径/usr/local/opt或/opt/homebrew/opt我举个例子你执行brew install python3.11Homebrew会先把Python 3.11装到Cellar下然后在bin目录里生成一个python3.11的软链接同时根据依赖关系把openssl、sqlite这些组件放到opt目录下。这样设计的好处是多个软件可以共存不同版本想切换时只需要调整PATH优先级。2.2 Formula和Cask到底什么区别这是很多人用Homebrew时最容易混淆的概念。简单一句话Formula管命令行工具Cask管图形界面App。Formula比如nginx、git、node、redis这类底层软件。安装命令是brew install xxx安装后进入的是Cellar目录提供的是命令行接口。Cask比如Google Chrome、Visual Studio Code、WeChat这类带图标的桌面应用。安装命令是brew install --cask xxx安装后它其实帮你把dmg下载、挂载、拷贝到/Applications这些步骤全自动执行了。我自己的使用习惯是命令行工具一律用普通brew install安装桌面应用也尽量用Cask管理这样以后升级、卸载都有统一入口不用一个一个手动去拖图标删App。2.3 Homebrew为何选择Ruby作为核心语言不少读者可能会问一个包管理器而已为什么要用Ruby写而不是Python或者Go这里有一段历史原因但更关键的是它在设计上的取舍Homebrew最早的实现者Max Howell是macOS上知名的Ruby开发者在2009年前后macOS默认自带Ruby环境直接用Ruby写可以让用户在安装Homebrew时几乎没有任何额外依赖。后来虽然macOS不再自带Ruby了但安装器也内置了一套精简的Ruby运行时所以用户依然不需要自己装Ruby。用Ruby写的好处是脚本灵活、表达力强Formula文件读起来像配置文件一样清晰。缺点是自动化执行性能一般但日常使用brew命令根本感觉不到瓶颈。3. 从零开始安装Homebrew与国内源配置3.1 安装前需要准备什么在跑安装命令之前有两件事要确认第一macOS版本不能太旧Homebrew目前要求macOS Monterey12以上Linux系统则需要有Ruby、curl等基础工具第二电脑上要装Xcode Command Line Tools它是很多编译行为的基础环境。如果没有装Command Line Tools你在终端里执行brew命令时系统会自动弹出安装窗口。当然也可以手动先装xcode-select --install然后执行Homebrew官方安装脚本。不同芯片架构的安装路径略有差异Apple Silicon机器默认安装在/opt/homebrewIntel机器默认安装在/usr/local安装脚本会自动识别。3.2 国内镜像源配置的完整流程安装时最让人头疼的就是下载慢。Homebrew官方脚本需要从GitHub拉取代码而很多国内网络环境访问GitHub并不顺畅导致安装过程卡很久。这时候我建议直接用国内镜像源安装。以中科大源为例先执行环境变量设置再跑官方脚本export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.ustc.edu.cn/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.ustc.edu.cn/homebrew-core.git export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.ustc.edu.cn/homebrew-bottles设置好之后再执行官方那个长命令整个下载过程就会快很多。装完之后还有两个源需要配置一个是homebrew-core所有Formula的仓库另一个是homebrew-cask所有Cask的仓库。如果你是直接从官方源安装完可以事后通过git remote命令切换cd $(brew --repo) git remote set-url origin https://mirrors.ustc.edu.cn/brew.git cd $(brew --repo)/Library/Taps/homebrew/homebrew-core git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-core.git cd $(brew --repo)/Library/Taps/homebrew/homebrew-cask git remote set-url origin https://mirrors.ustc.edu.cn/homebrew-cask.git这里我提醒一句镜像源只影响brew工具本身和软件包的下载不影响你之后软件的使用。清华源、阿里源也都是类似思路选一个离你近的就行。别同时配置多个源反而容易出问题。3.3 安装后的环境变量配置安装完成后Homebrew会提示你把核心入口加到PATH环境变量里。不同芯片架构的配置路径不一样Apple Silicon配置/opt/homebrew/binIntel配置/usr/local/bin如果你使用zsh通常在~/.zprofile里加一行eval $(/opt/homebrew/bin/brew shellenv)加完之后执行source ~/.zprofile再运行brew --version看看是否显示版本号。如果显示出版本号说明安装成功。我遇到过不少新手卡在这一步原因是PATH没配好命令找不到。这时候别急着重装先确认一下配置文件有没有写对。4. Homebrew的日常基本操作详解4.1 常用命令速查与使用心得日常使用中我真正高频用到的基础命令其实就那几个。整理成一个速查表命令作用使用示例brew search搜索软件包brew search nginxbrew install安装软件包brew install nginxbrew install --cask安装图形Appbrew install --cask google-chromebrew uninstall卸载软件包brew uninstall nginxbrew list列出已安装包brew list --versionsbrew update更新Homebrew本身和Formula索引brew updatebrew upgrade升级已安装的软件包brew upgradebrew cleanup清理旧版本和下载缓存brew cleanup -sbrew doctor检查系统与Homebrew健康状况brew doctor这里分享两个我自己的使用心得。第一个心得是不要一上来就无脑brew upgrade全部升级。因为有些软件的高版本可能会破坏依赖兼容性尤其像OpenSSL、Python这类底层库升级后其他依赖它们的软件需要重新编译。我一般先在brew update之后用brew outdated看看有哪几个包需要升级然后一个一个升避免一次把所有包都升了。第二个心得是想查看某个软件详细信息时用brew info xxx能查出它的依赖、版本、安装状态、安装命令排错时特别有用。4.2 用brew services管理后台服务Homebrew里还有一个容易被低估的功能brew services。它能把MySQL、Redis、PostgreSQL这类需要常驻后台的服务管理起来替代手动启动和kill进程的操作。# 启动服务并设置为开机自启 brew services start redis # 停止服务 brew services stop redis # 重启服务 brew services restart mysql # 查看所有服务状态 brew services list这个命令的本质是把一个LaunchAgent配置生成了出来交给系统来托管所以才能真正做到系统重启后服务自动拉起。对开发机来说非常方便不用再自己写daemon配置。4.3 自定义tap扩展软件仓库边界Homebrew默认的homebrew/core仓库已经包含几万个软件了但总有你需要的软件不在其中。这时候可以用brew tap来添加第三方仓库。最典型的就是homebrew/services这个已经内置了和homebrew/cask-versions后者能让你安装多个版本的应用比如安装Java 8、Python 2.7这类老版本。brew tap homebrew/cask-versions brew install --cask java8如果你自己写了Formula也可以传到自己的Git仓库里然后通过brew tap别人下载。这是Homebrew生态能持续壮大的重要原因它把软件定义做成了开放的Git仓库协作模式。5. 安装报错、卸载残留与问题排查实录5.1 安装过程中最常见的报错提示与对策这里我整理几个我遇到过也帮别人排查过的高频报错并附上处理思路。报错一curl: (7) Failed to connect to raw.githubusercontent.com port 443: Operation timed out这是最经典的网络问题。原因就是安装脚本需要从GitHub的raw域名下载一个远程脚本但网络连不上。解决办法我前面已经写了用国内镜像源的环境变量再执行安装脚本或者直接用带镜像地址的安装命令。报错二Error: Permission denied rb_sysopen - /usr/local/Homebrew这种一般是权限问题。如果目录所有者不对会导致Homebrew无法写入。解决办法是递归修改目录所有者sudo chown -R $USER:admin /usr/local这个命令会把/usr/local目录的所有者改成当前用户之后就不用每次sudo了。注意如果你用的是Apple Silicon机器路径通常是/opt/homebrew同样思路处理。报错三Error: The following directories are not writable by your user这个和上面的情况类似。有的目录被安装包或系统占用用sudo chown修复一下目录所有权就行。但如果你不确认当前目录是否安全可以先用ls -ld /usr/local/bin看看所有者是谁再决定改不改权限避免误操作。5.2 卸载Homebrew后老是清不干净怎么办很多读者想知道“Homebrew卸载残留”怎么清理其实Homebrew官方提供了卸载脚本/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)脚本会尝试删除Cellar、Caskroom、bin里的软链接等核心文件但有些残留它并不会主动清比如缓存目录~/Library/Caches/Homebrew日志目录~/Library/Logs/Homebrew服务配置~/Library/LaunchAgents/homebrew.mxcl.*.plist应用数据~/Library/Application Support/Homebrew如果确认不再需要可以手动把这些目录删掉。但这里必须先说清楚卸载脚本运行前它会列出要删除的内容你最好先看一眼免得误删你自己手动创建的数据。5.3 升级后软件损坏架构与签名问题排查我在Apple Silicon机器上遇到过升级后某个命令行工具突然提示“无法打开因为无法验证开发者”的情况。这通常有两种原因一个是软件没有做ARM架构适配另一个是签名验证问题。解决办法先尝试用brew reinstall xxx强制重装该软件让安装过程重新生成本地签名。如果还不行检查它是不是需要Rosetta转译Intel时代的很多老工具在ARM机器上需要安装Rosetta 2softwareupdate --install-rosetta装完之后再用brew doctor检查一下通常就能正常用了。6. 进阶小技巧与个人经验补充这部分算是我自己用得比较顺手、但很多教程不会仔细讲的几个点。6.1 用brew bundle做开发环境一键部署brew bundle能把当前机器上安装的所有Package和Cask导出成一个清单文件换新电脑时直接一键安装这个对开发环境迁移特别实用。# 生成当前环境的Brewfile brew bundle dump --file~/Brewfile # 在另一台机器上安装清单里的所有内容 brew bundle install --file~/Brewfile这个文件本质是一个文本清单可以提交到Git仓库里。我自己的做法是每台工作电脑维护一个Brewfile新配置环境时先装Homebrew本身再跑一遍brew bundle install几分钟就把常用工具和App全部装回来了。6.2 不要忽略brew doctor给出的警告很多人把brew doctor当成可有可无的命令其实它扫描的是整个Homebrew环境的健康状态包括目录权限、symlink是否损坏、依赖是否一致、环境变量是否有冲突。我建议安装、升级之后都跑一遍看到警告也别慌它给出的提示一般都很直白照着执行即可。我在实际维护环境时至少每个季度跑一次brew doctor遇到Warning及时处理久而久之就不会积累出大问题。6.3 小心处理版本切换如果你同时装了python3.10、python3.11这种多版本工具Homebrew会自动在bin目录下生成带版本后缀的命令默认命令则指向高优先级版本。如果你想固定使用某个版本建议用brew link命令做版本切换# 让当前shell优先使用3.11 brew link python3.11 --force --overwrite这条命令会把对应版本的工具链接进bin目录。但注意--force参数会强制覆盖掉同名软链接执行前最好确认一下你当前环境里哪些工具依赖旧版本避免把已有环境搞乱。我在实际使用中踩过一次坑当时为了装一个老项目把open ssl链回了1.1版本结果其他好几个软件全部报动态库错误只能一个个排查重装。后来学乖了版本切换这种东西尽量在虚拟环境或容器里做别全局折腾。写在最后的一点体会用了Homebrew这么多年我最大的体会是好的工具链应该让人“忘掉”工具本身而不是整天跟工具作斗争。Homebrew之所以在macOS开发者中这么流行不只是因为它安装命令一行搞定更在于它的目录设计、依赖管理、升级策略都是有章法的这让它在长期使用中变得非常可靠。从第一次装Ruby时的束手无策到后来用brew bundle在半小时内在新机器上恢复完整开发环境Homebrew确实帮我节省了大量时间。如果你刚接触Mac开发建议先把本文提到的基础命令亲手跑一遍再慢慢研究tap、services、bundle这些进阶功能。等哪一天你发现自己在终端里敲brew install的时候一点犹豫都没有就说明你已经真正上手了。本文还有配套的精品资源点击获取