1. 项目概述为什么每个Mac用户都绕不开Homebrew如果你刚拿到一台全新的Mac或者准备深度使用它进行开发、数据分析甚至日常效率工具管理那么你很快就会遇到一个绕不开的名字Homebrew。它不是什么神秘的魔法而是一个被无数Mac用户奉为“神器”的包管理器。简单来说它就像Mac上的一个超级应用商店只不过里面卖的不是游戏或社交软件而是开发者工具、命令行程序和各种开源软件库。你可以通过几句简单的终端命令就完成从搜索、下载、安装到配置依赖的全过程彻底告别手动下载、解压、拖拽安装、配置环境变量的繁琐时代。我最初接触Homebrew时也经历过一段“手动党”的挣扎期。每次需要安装Python、Node.js或者像wget、tree这样的命令行工具都得去官网找下载链接处理.pkg安装器或者.tar.gz压缩包还得小心翼翼地配置PATH生怕把系统搞乱。直到用了Homebrew才发现原来软件管理可以如此优雅和高效。一个brew install python不仅装好了最新版本的Python连pip都一并配好了直接就能用。这种体验一旦用上就再也回不去了。对于Mac用户而言无论你是前端、后端、数据科学家还是仅仅想装一些好用的效率工具比如用ffmpeg处理视频用imagemagick处理图片Homebrew都能极大地提升你的工作效率和系统整洁度。它通过一个统一的命令接口管理着成千上万个被称为“Formula”安装配方的软件包自动处理软件之间的依赖关系让你可以专注于使用工具而不是折腾安装过程。接下来我就带你从零开始完成Homebrew的安装并深入分享一些让这个工具更好用的高阶技巧和避坑指南。2. 安装前的核心准备与环境检查在兴奋地输入安装命令之前花几分钟做好准备工作能避免90%的安装失败和后续使用问题。这就像盖房子前要勘察地质一样基础打好了后面才稳固。2.1 系统版本与权限确认首先你需要确认你的Mac系统版本。Homebrew对macOS的版本有一定要求通常支持当前及之前几个主要版本。你可以通过点击屏幕左上角的苹果菜单 - “关于本机”来查看。目前Homebrew官方推荐运行在macOS High Sierra (10.13) 或更高版本上。对于更老的系统虽然可能有社区维护的旧版支持但会遇到更多兼容性问题建议优先考虑升级系统。其次也是最重要的一步确保你拥有管理员权限并且终端Terminal是以当前用户身份运行的。Homebrew需要将软件安装到/usr/local在Apple Silicon芯片的Mac上默认是/opt/homebrew目录这个操作需要管理员权限。你不需要一直用sudo但安装脚本本身会通过提示你输入密码来获取临时权限。注意请务必使用你日常使用的、具有管理员权限的账户进行操作不要直接使用root用户。Homebrew的设计哲学之一就是避免使用sudo来运行brew命令本身这能提升安全性。2.2 命令行工具Command Line Tools的安装这是Homebrew运行的基石。macOS本身自带了很多基础的Unix工具但并不完整。Xcode Command Line Tools简称CLT包含了完整的编译器集合如gcc、clang、git、make等构建工具这些都是Homebrew从源代码编译某些软件时所必需的。检查是否已安装CLT的方法很简单打开终端你可以在“应用程序”-“实用工具”中找到“终端”输入以下命令xcode-select -p如果返回一个类似/Library/Developer/CommandLineTools的路径说明已经安装。如果返回xcode-select: error: command line tools are not installed...则需要安装。安装CLT有两种推荐方式直接安装无需完整Xcode在终端输入xcode-select --install会弹出一个软件更新对话框点击“安装”即可。这是最干净、最推荐的方式只会安装必要的命令行工具不会下载好几个G的Xcode IDE。通过App Store安装Xcode如果你后续需要进行iOS或macOS原生开发可以直接从App Store安装Xcode。安装后打开Xcode在偏好设置Preferences的“Locations”面板中确保“Command Line Tools”选项已经选中了一个版本。这种方式会占用大量磁盘空间仅推荐给确实需要Xcode图形界面的开发者。我个人强烈推荐第一种方式快速且节省空间。完成这一步后你的Mac就具备了编译和构建软件的基本能力。2.3 处理可能存在的旧版本或冲突如果你之前以其他方式尝试安装过Homebrew比如用了过时的脚本或者系统里存在一些手动安装的、可能与Homebrew管理冲突的软件比如自己编译安装的python放在/usr/local/bin最好在安装前进行清理。检查现有安装在终端运行which brew。如果返回一个路径如/usr/local/bin/brew说明已有安装。你可以尝试brew --version查看版本。如果决定重新安装需要先彻底卸载旧版。彻底卸载旧版Homebrew官方提供了卸载脚本。如果你的旧版安装在/usr/local下Intel芯片可以运行/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)脚本会提示你确认并列出将要删除的文件。对于Apple Silicon Mac默认安装在/opt/homebrew脚本也能正确识别并处理。卸载后根据提示手动删除残留的目录如/usr/local下的Homebrew相关文件夹是一个好习惯。清理/usr/local谨慎操作如果你是高级用户并且确定/usr/local目录下没有其他重要软件可以将其清空为一个干净的状态。但更安全的做法是在安装Homebrew后用brew重新安装你需要的所有工具让Homebrew统一管理。3. 选择与执行安装方案官方与国内镜像环境准备好了现在进入安装环节。你将面临两个主要选择使用官方脚本或使用国内镜像源脚本。这个选择直接决定了你的安装速度和后续体验。3.1 官方安装脚本解析Homebrew的官方安装命令是/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)我们来拆解一下这个命令/bin/bash -c “...”指定用Bash shell来执行后面引号内的命令字符串。curl -fsSL这是一个网络请求工具。-f(--fail)让HTTP错误在服务器端静默失败不输出HTML错误页面。-s(--silent)静默模式不显示进度条或错误信息。-S(--show-error)与-s配合在失败时显示错误。-L(--location)如果请求的URL发生了重定向自动跟随重定向。https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh这是安装脚本的URL。HEAD指向仓库的主分支确保你总是获取到最新的安装脚本。当你运行这行命令后脚本会检查系统环境macOS版本、权限、CLT等。提示你安装过程将要执行的步骤并需要你按回车键继续。提示你输入当前用户的登录密码输入时密码不可见以获取sudo权限。创建必要的目录/usr/local或/opt/homebrew。从GitHub克隆Homebrew的核心仓库Homebrew/brew到本地。将brew可执行文件链接到系统路径/usr/local/bin或/opt/homebrew/bin。运行brew update来更新自身对于新安装这步可能跳过或很快。建议你运行brew doctor来检查系统健康状况。官方脚本的潜在问题整个安装过程需要从GitHub克隆仓库。由于网络原因克隆Homebrew/brew或后续的Homebrew/homebrew-core仓库时速度可能非常慢甚至因连接超时而失败。你会看到Cloning into ‘/usr/local/Homebrew’...卡住很久最终可能报错error: RPC failed; curl 56 Failure when receiving data from the peer。3.2 国内镜像安装方案详解为了解决网络问题国内高校和组织维护了Homebrew的镜像源。使用镜像源安装速度会有质的飞跃。这里以清华大学开源软件镜像站为例介绍安装流程。方案一使用镜像安装脚本推荐清华大学Tuna镜像站提供了自动化的安装脚本它自动将仓库地址替换为镜像源。安装命令为/bin/bash -c $(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/misc/brew-install.sh)这个脚本的工作原理是先下载一个本地的安装脚本这个脚本内部将HOMEBREW_BREW_GIT_REMOTE和HOMEBREW_CORE_GIT_REMOTE等环境变量设置为清华镜像的地址然后再执行与官方类似的安装步骤。整个过程自动化程度高适合大多数用户。方案二手动设置镜像安装如果你希望对安装过程有更精细的控制或者镜像脚本有变化可以手动执行。其核心思路是在运行官方脚本前通过设置环境变量来“劫持”仓库地址。# 1. 设置临时环境变量仅对当前终端会话有效 export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git # 2. 运行官方安装脚本此时脚本会使用上面设置的镜像地址 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)这种方法更透明你可以清楚地知道仓库指向哪里。安装完成后这些环境变量就失效了后续的brew update等操作需要单独配置镜像我们会在下一章详述。安装过程实录与交互提示无论采用哪种方式安装脚本运行后你都会在终端看到类似的输出 Checking for sudo access (which may request your password)... Password: This script will install: /usr/local/bin/brew /usr/local/share/doc/homebrew /usr/local/share/man/man1/brew.1 ... The following new directories will be created: /usr/local/Cellar /usr/local/Homebrew ... Press RETURN/ENTER to continue or any other key to abort:输入密码并回车后脚本开始创建目录、克隆仓库。使用镜像时你会看到克隆地址是mirrors.tuna.tsinghua.edu.cn速度通常能达到几MB/s一分钟内即可完成。对于Apple Silicon (M1/M2/M3) Mac安装路径默认变为/opt/homebrew。这是为了与系统自带的/usr/local隔离避免与为Intel编译的旧软件冲突。脚本会自动识别芯片类型并选择正确路径。安装完成后脚本会给出非常重要的提示 Next steps: - Run these two commands in your terminal to add Homebrew to your PATH: echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv) - Run brew help to get started - Further documentation: https://docs.brew.sh对于Intel Mac路径通常是/usr/local/bin它默认已在系统的PATH环境变量中。而对于Apple Silicon Mac/opt/homebrew/bin不在默认PATH里所以需要按提示执行那两条命令。第一条命令将配置行永久写入你的shell配置文件~/.zprofile如果你使用Zsh这是macOS Catalina及之后版本的默认shell第二条命令立即在当前终端生效。4. 安装后关键配置与验证安装完成并不意味着万事大吉。正确的配置能让你日后使用起来更顺畅尤其是更新和安装软件的速度。4.1 配置环境变量PATH正如安装完成提示所言对于Apple Silicon Mac必须将Homebrew的二进制目录加入PATH。请严格按照提示操作# 这行命令将配置追加到你的 ~/.zprofile 文件末尾 echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile # 这行命令使配置在当前终端立即生效 eval $(/opt/homebrew/bin/brew shellenv)执行后可以运行echo $PATH查看应该能看到/opt/homebrew/bin出现在路径中。对于使用Bash shell的用户较老的系统配置文件可能是~/.bash_profile或~/.bashrc原理相同。实操心得如果你不确定自己用的是哪种shell可以运行echo $SHELL查看。Zsh会返回/bin/zshBash则返回/bin/bash。一定要把配置写入正确的文件否则重启终端后brew命令会找不到。4.2 配置国内镜像源以加速安装时用了镜像但Homebrew日常的update更新软件列表和安装软件时默认还是会从GitHub拉取。为了获得持久的速度提升需要更换Homebrew的“上游”源。更换Homebrew核心仓库源# 替换brew.git仓库 cd $(brew --repo) git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git # 替换homebrew-core.git仓库 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的二进制预编译包源BottlesBottles是Homebrew为常用软件提供的预编译包直接下载解压即可无需本地编译速度极快。需要根据你使用的Shell修改配置文件。对于Zshecho export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles ~/.zprofile source ~/.zprofile对于Bashecho export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles ~/.bash_profile source ~/.bash_profile可选更换Homebrew Cask源如果你也使用brew install --cask来安装图形界面应用如Chrome、Visual Studio Code也可以更换Cask源。但请注意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完成以上配置后运行brew update你应该能感受到更新速度飞快。4.3 运行brew doctor进行系统诊断这是Homebrew提供的一个极其有用的工具用于检查你的系统是否存在可能影响Homebrew运行的问题。安装配置完成后务必运行brew doctor它会进行一系列检查并给出警告Warning或错误Error信息。常见的提示及处理方法Warning: /usr/local occurs before /opt/homebrew in your PATH这通常发生在Apple Silicon Mac上如果你之前手动配置过PATH。这可能导致你运行的是旧版Intel软件而非新版Apple Silicon软件。需要调整你的shell配置文件如.zprofile确保/opt/homebrew/bin的路径在/usr/local/bin之前。Warning: Unbrewed dylibs were found in /usr/local/lib提示在/usr/local/lib目录下发现了非Homebrew安装的动态库。如果这些库是你不需要的旧软件残留可以安全删除。如果不确定可以暂时忽略但最好保持/usr/local的整洁。Warning: You have unlinked kegs in your Cellar表示有软件已安装在Cellar酒窖里但未链接link到/usr/local/bin或/opt/homebrew/bin。运行brew link formula可以链接或者用brew install --force formula重新安装。理想状态下brew doctor应该输出Your system is ready to brew.。请认真对待每一个警告它们能帮你避免许多诡异的问题。5. Homebrew基础与核心操作指南配置妥当系统健康现在可以开始畅快使用Homebrew了。我们来系统性地掌握它的核心操作。5.1 搜索、安装与卸载软件搜索软件在安装前最好先搜索确认软件包在Homebrew中的名称。# 模糊搜索会列出所有包含关键词的软件包 brew search python # 更精确的搜索使用正则表达式 brew search /^python3\.1[0-1]$/搜索结果显示你可能看到python、python3.9、python3.10等。符号表示软件的特定主要版本。Homebrew默认安装最新稳定版如python如果你想安装某个历史主要版本需要指定带的包名。安装软件# 安装最新稳定版 brew install python # 安装特定主要版本 brew install python3.11 # 安装图形界面应用Cask brew install --cask google-chrome # 安装时显示详细信息和进度 brew install -v wget安装过程你会看到首先下载软件包或源码Fetching然后检查完整性Verifying接着如果是Bottle则直接解压安装如果需要编译则会进行./configure,make,make install等步骤。卸载软件# 卸载软件包 brew uninstall python3.11 # 强制卸载即使有其他软件依赖它慎用 brew uninstall --force node # 卸载图形界面应用 brew uninstall --cask firefox卸载命令会移除该软件的所有文件但通常不会删除该软件的配置文件通常在你的用户目录下如~/.config或~/.appname。5.2 管理软件版本与升级查看已安装软件# 列出所有通过brew安装的软件包括Cask brew list # 仅列出Formula命令行工具 brew list --formula # 仅列出Cask图形应用 brew list --cask检查过时软件brew outdated这会列出所有有可用更新的软件包。升级软件# 升级所有可升级的软件包括Homebrew自身 brew upgrade # 仅升级某个特定软件 brew upgrade python # 升级所有Cask应用 brew upgrade --cask注意事项升级软件尤其是编程语言运行时如Python、Node.js可能会破坏现有项目对特定版本的依赖。在生产环境或关键项目中建议使用版本管理工具如pyenv、nvm来隔离项目环境而不是依赖Homebrew的全局升级。锁定软件版本防止意外升级 Homebrew本身没有直接的“锁定”命令。但你可以通过“pin”一个Formula来阻止其被brew upgrade升级。brew pin python3.11 # 查看被pin住的软件 brew list --pinned # 解除pin brew unpin python3.115.3 深入理解Formula、Cask与TapFormula这是Homebrew的核心概念是一个Ruby脚本文件定义了如何编译和安装一个命令行工具、库或开发框架。它包含了软件的元数据名称、版本、描述、依赖关系、下载地址、编译选项和安装步骤。Formula文件存放在Homebrew/homebrew-core这个核心仓库中。Cask是Formula的扩展用于管理macOS图形界面应用程序.app。Cask不处理编译而是处理下载、解压、移动.app文件到/Applications目录以及创建一些必要的链接或处理一些安装后步骤如卸载脚本。Cask文件存放在Homebrew/homebrew-cask仓库中。Tap可以理解为Homebrew的“软件源”或“仓库”。官方核心的Tap就是homebrew/core和homebrew/cask。但Homebrew社区非常活跃许多个人或组织维护着第三方Tap提供官方尚未收录的软件或特定领域的软件集合。# 添加一个第三方Tap例如一个专门用于字体管理的Tap brew tap homebrew/cask-fonts # 查看已添加的所有Tap brew tap # 安装来自特定Tap的软件 brew install homebrew/cask-fonts/font-fira-code # 移除一个Tap不会卸载通过它安装的软件 brew untap homebrew/cask-fonts使用第三方Tap能极大地扩展Homebrew的能力但需要注意来源的可信度。6. 高级技巧、问题排查与维护掌握了基础操作你已经能应对90%的需求。下面这些高级技巧和问题排查方法能让你成为Homebrew高手并保持系统长期稳定。6.1 依赖管理与深度清理Homebrew自动处理依赖但有时你需要了解或干预。查看软件依赖树# 查看安装一个软件前需要哪些依赖 brew deps --tree python # 查看哪些软件依赖了某个软件反向依赖 brew uses --installed openssl清理缓存与旧版本 Homebrew在下载和安装过程中会产生缓存升级软件后旧版本也会保留在Cellar中方便回滚。定期清理可以释放磁盘空间。# 删除所有软件的旧版本只保留最新版 brew cleanup # 查看如果执行cleanup会删除哪些文件模拟运行 brew cleanup -n # 强制删除所有缓存文件即使缓存未过期 brew cleanup --pruneall # 卸载某个软件及其所有未使用的依赖 brew autoremove我个人的习惯是每月运行一次brew cleanup brew autoremove。对于存储空间紧张的MacBook用户这能轻松清理出几个G的空间。6.2 常见安装失败问题与解决方案即使配置了镜像安装过程中也可能遇到各种问题。以下是一些常见错误及排查思路Error: Checksum mismatch问题下载的文件校验和不匹配。通常是因为网络传输中文件损坏或镜像源的文件与官方源不一致同步延迟。解决# 删除该软件的缓存重新下载 brew cleanup formula brew install formula # 如果多次失败可以尝试用--force-bottle强制使用预编译包如果可用 brew install --force-bottle formula # 或者暂时禁用校验仅用于测试不推荐 brew install --ignore-dependencies formulaError: Failed to download resource “...”问题下载某个资源可能是源码包也可能是bottle失败。网络问题或资源URL失效。解决首先运行brew update确保Formula信息是最新的。检查网络连接尝试切换网络。对于bottle失败可以尝试从源码编译安装会慢很多brew install --build-from-source formulaError: Your Command Line Tools are too outdated.问题CLT版本过旧无法编译某些新软件。解决更新Command Line Tools。# 删除现有版本并重新安装 sudo rm -rf /Library/Developer/CommandLineTools xcode-select --installError: No available formula with the name “...”问题软件名拼写错误或者该软件不在你已添加的Tap中。解决用brew search确认正确的包名。考虑是否需要添加第三方Tap。例如安装特定版本的PHP可能需要brew tap shivammathur/php。安装或运行软件时提示 “Permission denied”问题权限不足。Homebrew安装的软件目录/usr/local或/opt/homebrew应该属于当前用户和管理员组并且有正确的权限。解决# 修复Homebrew目录的权限将USER替换为你的用户名 sudo chown -R $(whoami):admin /usr/local/* # 对于Apple Silicon Mac sudo chown -R $(whoami):admin /opt/homebrew/*执行后再次尝试安装。6.3 备份、迁移与完全卸载备份已安装软件列表 在重装系统或换新电脑前可以轻松备份你的Homebrew环境。# 生成已安装Formula列表 brew leaves brew_formulas.txt # 生成已安装Cask列表 brew list --cask brew_casks.txt在新机器上安装好Homebrew后可以批量安装# 安装所有Formula xargs brew install brew_formulas.txt # 安装所有Cask xargs brew install --cask brew_casks.txt从Intel Mac迁移到Apple Silicon Mac 如果你换了M系列芯片的Mac不建议直接迁移/usr/local目录。最佳实践是在新电脑上按照本文步骤安装Homebrew会自动安装到/opt/homebrew。用上述方法备份旧电脑的软件列表。在新电脑上根据列表重新安装。对于需要编译的软件Homebrew会自动提供ARM原生版本性能更好。完全卸载Homebrew 如果你决定不再使用Homebrew或者需要彻底重装请使用官方卸载脚本前面提到过。卸载后建议手动检查并清理以下目录/usr/local(Intel) 或/opt/homebrew(Apple Silicon)删除Homebrew、Cellar、Caskroom等子目录。~/.cache/Homebrew删除缓存目录。从你的shell配置文件.zprofile.bash_profile中移除与Homebrew PATH相关的行。最后运行which brew和brew --version应该返回“未找到命令”即表示卸载干净。
Mac包管理器Homebrew从零安装到高阶配置全指南
1. 项目概述为什么每个Mac用户都绕不开Homebrew如果你刚拿到一台全新的Mac或者准备深度使用它进行开发、数据分析甚至日常效率工具管理那么你很快就会遇到一个绕不开的名字Homebrew。它不是什么神秘的魔法而是一个被无数Mac用户奉为“神器”的包管理器。简单来说它就像Mac上的一个超级应用商店只不过里面卖的不是游戏或社交软件而是开发者工具、命令行程序和各种开源软件库。你可以通过几句简单的终端命令就完成从搜索、下载、安装到配置依赖的全过程彻底告别手动下载、解压、拖拽安装、配置环境变量的繁琐时代。我最初接触Homebrew时也经历过一段“手动党”的挣扎期。每次需要安装Python、Node.js或者像wget、tree这样的命令行工具都得去官网找下载链接处理.pkg安装器或者.tar.gz压缩包还得小心翼翼地配置PATH生怕把系统搞乱。直到用了Homebrew才发现原来软件管理可以如此优雅和高效。一个brew install python不仅装好了最新版本的Python连pip都一并配好了直接就能用。这种体验一旦用上就再也回不去了。对于Mac用户而言无论你是前端、后端、数据科学家还是仅仅想装一些好用的效率工具比如用ffmpeg处理视频用imagemagick处理图片Homebrew都能极大地提升你的工作效率和系统整洁度。它通过一个统一的命令接口管理着成千上万个被称为“Formula”安装配方的软件包自动处理软件之间的依赖关系让你可以专注于使用工具而不是折腾安装过程。接下来我就带你从零开始完成Homebrew的安装并深入分享一些让这个工具更好用的高阶技巧和避坑指南。2. 安装前的核心准备与环境检查在兴奋地输入安装命令之前花几分钟做好准备工作能避免90%的安装失败和后续使用问题。这就像盖房子前要勘察地质一样基础打好了后面才稳固。2.1 系统版本与权限确认首先你需要确认你的Mac系统版本。Homebrew对macOS的版本有一定要求通常支持当前及之前几个主要版本。你可以通过点击屏幕左上角的苹果菜单 - “关于本机”来查看。目前Homebrew官方推荐运行在macOS High Sierra (10.13) 或更高版本上。对于更老的系统虽然可能有社区维护的旧版支持但会遇到更多兼容性问题建议优先考虑升级系统。其次也是最重要的一步确保你拥有管理员权限并且终端Terminal是以当前用户身份运行的。Homebrew需要将软件安装到/usr/local在Apple Silicon芯片的Mac上默认是/opt/homebrew目录这个操作需要管理员权限。你不需要一直用sudo但安装脚本本身会通过提示你输入密码来获取临时权限。注意请务必使用你日常使用的、具有管理员权限的账户进行操作不要直接使用root用户。Homebrew的设计哲学之一就是避免使用sudo来运行brew命令本身这能提升安全性。2.2 命令行工具Command Line Tools的安装这是Homebrew运行的基石。macOS本身自带了很多基础的Unix工具但并不完整。Xcode Command Line Tools简称CLT包含了完整的编译器集合如gcc、clang、git、make等构建工具这些都是Homebrew从源代码编译某些软件时所必需的。检查是否已安装CLT的方法很简单打开终端你可以在“应用程序”-“实用工具”中找到“终端”输入以下命令xcode-select -p如果返回一个类似/Library/Developer/CommandLineTools的路径说明已经安装。如果返回xcode-select: error: command line tools are not installed...则需要安装。安装CLT有两种推荐方式直接安装无需完整Xcode在终端输入xcode-select --install会弹出一个软件更新对话框点击“安装”即可。这是最干净、最推荐的方式只会安装必要的命令行工具不会下载好几个G的Xcode IDE。通过App Store安装Xcode如果你后续需要进行iOS或macOS原生开发可以直接从App Store安装Xcode。安装后打开Xcode在偏好设置Preferences的“Locations”面板中确保“Command Line Tools”选项已经选中了一个版本。这种方式会占用大量磁盘空间仅推荐给确实需要Xcode图形界面的开发者。我个人强烈推荐第一种方式快速且节省空间。完成这一步后你的Mac就具备了编译和构建软件的基本能力。2.3 处理可能存在的旧版本或冲突如果你之前以其他方式尝试安装过Homebrew比如用了过时的脚本或者系统里存在一些手动安装的、可能与Homebrew管理冲突的软件比如自己编译安装的python放在/usr/local/bin最好在安装前进行清理。检查现有安装在终端运行which brew。如果返回一个路径如/usr/local/bin/brew说明已有安装。你可以尝试brew --version查看版本。如果决定重新安装需要先彻底卸载旧版。彻底卸载旧版Homebrew官方提供了卸载脚本。如果你的旧版安装在/usr/local下Intel芯片可以运行/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/uninstall.sh)脚本会提示你确认并列出将要删除的文件。对于Apple Silicon Mac默认安装在/opt/homebrew脚本也能正确识别并处理。卸载后根据提示手动删除残留的目录如/usr/local下的Homebrew相关文件夹是一个好习惯。清理/usr/local谨慎操作如果你是高级用户并且确定/usr/local目录下没有其他重要软件可以将其清空为一个干净的状态。但更安全的做法是在安装Homebrew后用brew重新安装你需要的所有工具让Homebrew统一管理。3. 选择与执行安装方案官方与国内镜像环境准备好了现在进入安装环节。你将面临两个主要选择使用官方脚本或使用国内镜像源脚本。这个选择直接决定了你的安装速度和后续体验。3.1 官方安装脚本解析Homebrew的官方安装命令是/bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)我们来拆解一下这个命令/bin/bash -c “...”指定用Bash shell来执行后面引号内的命令字符串。curl -fsSL这是一个网络请求工具。-f(--fail)让HTTP错误在服务器端静默失败不输出HTML错误页面。-s(--silent)静默模式不显示进度条或错误信息。-S(--show-error)与-s配合在失败时显示错误。-L(--location)如果请求的URL发生了重定向自动跟随重定向。https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh这是安装脚本的URL。HEAD指向仓库的主分支确保你总是获取到最新的安装脚本。当你运行这行命令后脚本会检查系统环境macOS版本、权限、CLT等。提示你安装过程将要执行的步骤并需要你按回车键继续。提示你输入当前用户的登录密码输入时密码不可见以获取sudo权限。创建必要的目录/usr/local或/opt/homebrew。从GitHub克隆Homebrew的核心仓库Homebrew/brew到本地。将brew可执行文件链接到系统路径/usr/local/bin或/opt/homebrew/bin。运行brew update来更新自身对于新安装这步可能跳过或很快。建议你运行brew doctor来检查系统健康状况。官方脚本的潜在问题整个安装过程需要从GitHub克隆仓库。由于网络原因克隆Homebrew/brew或后续的Homebrew/homebrew-core仓库时速度可能非常慢甚至因连接超时而失败。你会看到Cloning into ‘/usr/local/Homebrew’...卡住很久最终可能报错error: RPC failed; curl 56 Failure when receiving data from the peer。3.2 国内镜像安装方案详解为了解决网络问题国内高校和组织维护了Homebrew的镜像源。使用镜像源安装速度会有质的飞跃。这里以清华大学开源软件镜像站为例介绍安装流程。方案一使用镜像安装脚本推荐清华大学Tuna镜像站提供了自动化的安装脚本它自动将仓库地址替换为镜像源。安装命令为/bin/bash -c $(curl -fsSL https://mirrors.tuna.tsinghua.edu.cn/misc/brew-install.sh)这个脚本的工作原理是先下载一个本地的安装脚本这个脚本内部将HOMEBREW_BREW_GIT_REMOTE和HOMEBREW_CORE_GIT_REMOTE等环境变量设置为清华镜像的地址然后再执行与官方类似的安装步骤。整个过程自动化程度高适合大多数用户。方案二手动设置镜像安装如果你希望对安装过程有更精细的控制或者镜像脚本有变化可以手动执行。其核心思路是在运行官方脚本前通过设置环境变量来“劫持”仓库地址。# 1. 设置临时环境变量仅对当前终端会话有效 export HOMEBREW_BREW_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git export HOMEBREW_CORE_GIT_REMOTEhttps://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git # 2. 运行官方安装脚本此时脚本会使用上面设置的镜像地址 /bin/bash -c $(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)这种方法更透明你可以清楚地知道仓库指向哪里。安装完成后这些环境变量就失效了后续的brew update等操作需要单独配置镜像我们会在下一章详述。安装过程实录与交互提示无论采用哪种方式安装脚本运行后你都会在终端看到类似的输出 Checking for sudo access (which may request your password)... Password: This script will install: /usr/local/bin/brew /usr/local/share/doc/homebrew /usr/local/share/man/man1/brew.1 ... The following new directories will be created: /usr/local/Cellar /usr/local/Homebrew ... Press RETURN/ENTER to continue or any other key to abort:输入密码并回车后脚本开始创建目录、克隆仓库。使用镜像时你会看到克隆地址是mirrors.tuna.tsinghua.edu.cn速度通常能达到几MB/s一分钟内即可完成。对于Apple Silicon (M1/M2/M3) Mac安装路径默认变为/opt/homebrew。这是为了与系统自带的/usr/local隔离避免与为Intel编译的旧软件冲突。脚本会自动识别芯片类型并选择正确路径。安装完成后脚本会给出非常重要的提示 Next steps: - Run these two commands in your terminal to add Homebrew to your PATH: echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile eval $(/opt/homebrew/bin/brew shellenv) - Run brew help to get started - Further documentation: https://docs.brew.sh对于Intel Mac路径通常是/usr/local/bin它默认已在系统的PATH环境变量中。而对于Apple Silicon Mac/opt/homebrew/bin不在默认PATH里所以需要按提示执行那两条命令。第一条命令将配置行永久写入你的shell配置文件~/.zprofile如果你使用Zsh这是macOS Catalina及之后版本的默认shell第二条命令立即在当前终端生效。4. 安装后关键配置与验证安装完成并不意味着万事大吉。正确的配置能让你日后使用起来更顺畅尤其是更新和安装软件的速度。4.1 配置环境变量PATH正如安装完成提示所言对于Apple Silicon Mac必须将Homebrew的二进制目录加入PATH。请严格按照提示操作# 这行命令将配置追加到你的 ~/.zprofile 文件末尾 echo eval $(/opt/homebrew/bin/brew shellenv) ~/.zprofile # 这行命令使配置在当前终端立即生效 eval $(/opt/homebrew/bin/brew shellenv)执行后可以运行echo $PATH查看应该能看到/opt/homebrew/bin出现在路径中。对于使用Bash shell的用户较老的系统配置文件可能是~/.bash_profile或~/.bashrc原理相同。实操心得如果你不确定自己用的是哪种shell可以运行echo $SHELL查看。Zsh会返回/bin/zshBash则返回/bin/bash。一定要把配置写入正确的文件否则重启终端后brew命令会找不到。4.2 配置国内镜像源以加速安装时用了镜像但Homebrew日常的update更新软件列表和安装软件时默认还是会从GitHub拉取。为了获得持久的速度提升需要更换Homebrew的“上游”源。更换Homebrew核心仓库源# 替换brew.git仓库 cd $(brew --repo) git remote set-url origin https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git # 替换homebrew-core.git仓库 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的二进制预编译包源BottlesBottles是Homebrew为常用软件提供的预编译包直接下载解压即可无需本地编译速度极快。需要根据你使用的Shell修改配置文件。对于Zshecho export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles ~/.zprofile source ~/.zprofile对于Bashecho export HOMEBREW_BOTTLE_DOMAINhttps://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles ~/.bash_profile source ~/.bash_profile可选更换Homebrew Cask源如果你也使用brew install --cask来安装图形界面应用如Chrome、Visual Studio Code也可以更换Cask源。但请注意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完成以上配置后运行brew update你应该能感受到更新速度飞快。4.3 运行brew doctor进行系统诊断这是Homebrew提供的一个极其有用的工具用于检查你的系统是否存在可能影响Homebrew运行的问题。安装配置完成后务必运行brew doctor它会进行一系列检查并给出警告Warning或错误Error信息。常见的提示及处理方法Warning: /usr/local occurs before /opt/homebrew in your PATH这通常发生在Apple Silicon Mac上如果你之前手动配置过PATH。这可能导致你运行的是旧版Intel软件而非新版Apple Silicon软件。需要调整你的shell配置文件如.zprofile确保/opt/homebrew/bin的路径在/usr/local/bin之前。Warning: Unbrewed dylibs were found in /usr/local/lib提示在/usr/local/lib目录下发现了非Homebrew安装的动态库。如果这些库是你不需要的旧软件残留可以安全删除。如果不确定可以暂时忽略但最好保持/usr/local的整洁。Warning: You have unlinked kegs in your Cellar表示有软件已安装在Cellar酒窖里但未链接link到/usr/local/bin或/opt/homebrew/bin。运行brew link formula可以链接或者用brew install --force formula重新安装。理想状态下brew doctor应该输出Your system is ready to brew.。请认真对待每一个警告它们能帮你避免许多诡异的问题。5. Homebrew基础与核心操作指南配置妥当系统健康现在可以开始畅快使用Homebrew了。我们来系统性地掌握它的核心操作。5.1 搜索、安装与卸载软件搜索软件在安装前最好先搜索确认软件包在Homebrew中的名称。# 模糊搜索会列出所有包含关键词的软件包 brew search python # 更精确的搜索使用正则表达式 brew search /^python3\.1[0-1]$/搜索结果显示你可能看到python、python3.9、python3.10等。符号表示软件的特定主要版本。Homebrew默认安装最新稳定版如python如果你想安装某个历史主要版本需要指定带的包名。安装软件# 安装最新稳定版 brew install python # 安装特定主要版本 brew install python3.11 # 安装图形界面应用Cask brew install --cask google-chrome # 安装时显示详细信息和进度 brew install -v wget安装过程你会看到首先下载软件包或源码Fetching然后检查完整性Verifying接着如果是Bottle则直接解压安装如果需要编译则会进行./configure,make,make install等步骤。卸载软件# 卸载软件包 brew uninstall python3.11 # 强制卸载即使有其他软件依赖它慎用 brew uninstall --force node # 卸载图形界面应用 brew uninstall --cask firefox卸载命令会移除该软件的所有文件但通常不会删除该软件的配置文件通常在你的用户目录下如~/.config或~/.appname。5.2 管理软件版本与升级查看已安装软件# 列出所有通过brew安装的软件包括Cask brew list # 仅列出Formula命令行工具 brew list --formula # 仅列出Cask图形应用 brew list --cask检查过时软件brew outdated这会列出所有有可用更新的软件包。升级软件# 升级所有可升级的软件包括Homebrew自身 brew upgrade # 仅升级某个特定软件 brew upgrade python # 升级所有Cask应用 brew upgrade --cask注意事项升级软件尤其是编程语言运行时如Python、Node.js可能会破坏现有项目对特定版本的依赖。在生产环境或关键项目中建议使用版本管理工具如pyenv、nvm来隔离项目环境而不是依赖Homebrew的全局升级。锁定软件版本防止意外升级 Homebrew本身没有直接的“锁定”命令。但你可以通过“pin”一个Formula来阻止其被brew upgrade升级。brew pin python3.11 # 查看被pin住的软件 brew list --pinned # 解除pin brew unpin python3.115.3 深入理解Formula、Cask与TapFormula这是Homebrew的核心概念是一个Ruby脚本文件定义了如何编译和安装一个命令行工具、库或开发框架。它包含了软件的元数据名称、版本、描述、依赖关系、下载地址、编译选项和安装步骤。Formula文件存放在Homebrew/homebrew-core这个核心仓库中。Cask是Formula的扩展用于管理macOS图形界面应用程序.app。Cask不处理编译而是处理下载、解压、移动.app文件到/Applications目录以及创建一些必要的链接或处理一些安装后步骤如卸载脚本。Cask文件存放在Homebrew/homebrew-cask仓库中。Tap可以理解为Homebrew的“软件源”或“仓库”。官方核心的Tap就是homebrew/core和homebrew/cask。但Homebrew社区非常活跃许多个人或组织维护着第三方Tap提供官方尚未收录的软件或特定领域的软件集合。# 添加一个第三方Tap例如一个专门用于字体管理的Tap brew tap homebrew/cask-fonts # 查看已添加的所有Tap brew tap # 安装来自特定Tap的软件 brew install homebrew/cask-fonts/font-fira-code # 移除一个Tap不会卸载通过它安装的软件 brew untap homebrew/cask-fonts使用第三方Tap能极大地扩展Homebrew的能力但需要注意来源的可信度。6. 高级技巧、问题排查与维护掌握了基础操作你已经能应对90%的需求。下面这些高级技巧和问题排查方法能让你成为Homebrew高手并保持系统长期稳定。6.1 依赖管理与深度清理Homebrew自动处理依赖但有时你需要了解或干预。查看软件依赖树# 查看安装一个软件前需要哪些依赖 brew deps --tree python # 查看哪些软件依赖了某个软件反向依赖 brew uses --installed openssl清理缓存与旧版本 Homebrew在下载和安装过程中会产生缓存升级软件后旧版本也会保留在Cellar中方便回滚。定期清理可以释放磁盘空间。# 删除所有软件的旧版本只保留最新版 brew cleanup # 查看如果执行cleanup会删除哪些文件模拟运行 brew cleanup -n # 强制删除所有缓存文件即使缓存未过期 brew cleanup --pruneall # 卸载某个软件及其所有未使用的依赖 brew autoremove我个人的习惯是每月运行一次brew cleanup brew autoremove。对于存储空间紧张的MacBook用户这能轻松清理出几个G的空间。6.2 常见安装失败问题与解决方案即使配置了镜像安装过程中也可能遇到各种问题。以下是一些常见错误及排查思路Error: Checksum mismatch问题下载的文件校验和不匹配。通常是因为网络传输中文件损坏或镜像源的文件与官方源不一致同步延迟。解决# 删除该软件的缓存重新下载 brew cleanup formula brew install formula # 如果多次失败可以尝试用--force-bottle强制使用预编译包如果可用 brew install --force-bottle formula # 或者暂时禁用校验仅用于测试不推荐 brew install --ignore-dependencies formulaError: Failed to download resource “...”问题下载某个资源可能是源码包也可能是bottle失败。网络问题或资源URL失效。解决首先运行brew update确保Formula信息是最新的。检查网络连接尝试切换网络。对于bottle失败可以尝试从源码编译安装会慢很多brew install --build-from-source formulaError: Your Command Line Tools are too outdated.问题CLT版本过旧无法编译某些新软件。解决更新Command Line Tools。# 删除现有版本并重新安装 sudo rm -rf /Library/Developer/CommandLineTools xcode-select --installError: No available formula with the name “...”问题软件名拼写错误或者该软件不在你已添加的Tap中。解决用brew search确认正确的包名。考虑是否需要添加第三方Tap。例如安装特定版本的PHP可能需要brew tap shivammathur/php。安装或运行软件时提示 “Permission denied”问题权限不足。Homebrew安装的软件目录/usr/local或/opt/homebrew应该属于当前用户和管理员组并且有正确的权限。解决# 修复Homebrew目录的权限将USER替换为你的用户名 sudo chown -R $(whoami):admin /usr/local/* # 对于Apple Silicon Mac sudo chown -R $(whoami):admin /opt/homebrew/*执行后再次尝试安装。6.3 备份、迁移与完全卸载备份已安装软件列表 在重装系统或换新电脑前可以轻松备份你的Homebrew环境。# 生成已安装Formula列表 brew leaves brew_formulas.txt # 生成已安装Cask列表 brew list --cask brew_casks.txt在新机器上安装好Homebrew后可以批量安装# 安装所有Formula xargs brew install brew_formulas.txt # 安装所有Cask xargs brew install --cask brew_casks.txt从Intel Mac迁移到Apple Silicon Mac 如果你换了M系列芯片的Mac不建议直接迁移/usr/local目录。最佳实践是在新电脑上按照本文步骤安装Homebrew会自动安装到/opt/homebrew。用上述方法备份旧电脑的软件列表。在新电脑上根据列表重新安装。对于需要编译的软件Homebrew会自动提供ARM原生版本性能更好。完全卸载Homebrew 如果你决定不再使用Homebrew或者需要彻底重装请使用官方卸载脚本前面提到过。卸载后建议手动检查并清理以下目录/usr/local(Intel) 或/opt/homebrew(Apple Silicon)删除Homebrew、Cellar、Caskroom等子目录。~/.cache/Homebrew删除缓存目录。从你的shell配置文件.zprofile.bash_profile中移除与Homebrew PATH相关的行。最后运行which brew和brew --version应该返回“未找到命令”即表示卸载干净。