外观
使用 Homebrew 管理工具
适用范围:需要管理命令行工具或应用的 Mac 用户。2026-09-14 核查的官方安装文档以 Apple 芯片、macOS Sequoia 15 及以后为主要支持条件,并将 Intel 标为 Tier 3;旧系统或 Intel 用户安装前务必重新核对支持层级。它们不能被视为与当前主支持环境同等保证。Homebrew:安装要求
什么时候需要它
Homebrew 是第三方软件包管理器,方便查询、安装和更新开发及命令行工具。formula 常用于命令行软件及其依赖,cask 用于分发应用等预构建软件。它不是 Apple 官方服务,也不会让原本付费的软件变成免费授权。Homebrew:术语与命令
如果目前只用浏览器和办公软件,可以暂缓安装。需要某个命令时,再决定用 Homebrew 还是开发者自己的安装方式,避免同一工具装出几套来源不明的副本。
从官网安装并理解位置
- 打开 Homebrew 官网,进入安装说明,核对硬件和 macOS 要求。
- 根据官方说明准备 Xcode Command Line Tools;可先用
xcode-select -p查询已选择的开发工具路径。没有安装时,再按官方说明运行xcode-select --install并阅读系统安装提示;后者会下载安装工具,不是只读检查,也不要求先下载整个 Xcode。 - 使用官网当前提供的安装方式。终端安装脚本会下载并执行代码,运行前应核对
brew.sh指向的官方仓库、阅读将要创建的目录及权限提示。不要从搜索广告或无法确认维护方的镜像复制“一键修复”命令;替换镜像意味着同时把信任交给镜像维护者。 - 安装结束后按屏幕输出的后续步骤配置 Shell,再打开新的终端窗口。
默认前缀通常是 Apple 芯片的 /opt/homebrew 和 Intel 的 /usr/local。不要把另一台电脑的配置机械复制过来,也不要为了兼容旧教程在 Apple 芯片 Mac 上随意建立第二套 Intel 环境。实际路径以安装输出与 brew --prefix 为准。Homebrew:安装后配置
初次安装可能请求管理员授权;这不等于以后每条 brew 都要管理员权限。Shell 配置也只追加安装器针对本机给出的内容,不覆盖已有配置文件。若新终端提示找不到 brew,先核对安装位置和后续步骤,不立即重装第二份。
zsh
brew --version
brew --prefix
brew doctor前两项确认命令可用及其位置;brew doctor 提供诊断建议,出现警告不等于所有软件都已损坏。读清每条建议再处理。
先查询,再安装或升级
zsh
brew search wget
brew info wget先了解目标与依赖,确定需要后再运行 brew install wget。安装会下载并写入软件与依赖目录;日常不要给 brew install 加 sudo。wget 是下载工具,并非使用 Mac 的必备条件,练习可以停在查询阶段。
定向升级,不把更新当成无影响操作
升级前保存工作,记录正在使用的版本,并备份依赖这些工具的重要项目。即使只指定一个包,也可能联动升级依赖及相关软件;Homebrew 不承诺任意版本混搭或一键退回旧版。Homebrew:依赖升级与旧版本
对于已经安装的 wget,按下面顺序查看:
zsh
brew update
brew outdated
brew upgrade --dry-run wgetupdate 更新 Homebrew 及软件定义,不等于把已安装工具全部升级;outdated 列出可升级项目;--dry-run 预览本次会升级什么,不执行软件升级。确认范围后才运行 brew upgrade wget,再用 wget --version 核对。Homebrew:命令说明
不带目标的 brew upgrade 会尝试升级所有符合条件的已安装项目,不应当作每次打开终端的准备命令。先理解 GUI 应用是否还使用自己的更新器,不要混用多套升级方式后仅凭 Homebrew 的记录判断实际版本。
用 --cask 安装图形界面应用
formula 常用于命令行工具及其依赖,cask 用于分发 .app、字体、驱动等预构建软件。两者用同一套 brew 命令,通过 --cask 区分:
zsh
brew search --cask visual-studio-code
brew info --cask visual-studio-code
brew install --cask visual-studio-code从 Homebrew 2.6 起 brew cask install 这类旧写法已被弃用,教程里若还出现 brew cask ...,说明内容过时,应改用 brew <命令> --cask。Homebrew:brew cask 已弃用
几点和 formula 不同的地方:
- 直接分发的
.app默认放在/Applications(可通过--appdir指定其他目录);字体、驱动或.pkg的安装位置取决于各自的安装规则。Homebrew:Cask 安装选项 - 部分 cask 需要管理员密码,因为要把
.app移入系统目录或安装.pkg、系统扩展。这属于正常提示,但仍应确认自己装的是哪个软件。 - cask 只是帮你下载开发者官方发布的安装包,不改变授权方式。付费软件仍需自行购买许可证。
名称冲突时注意区分:同一个关键字可能既有 formula 又有 cask(例如 docker 是命令行工具,docker-desktop 是应用),brew search 的输出会分两组列出,安装前先用 brew info 核对。
升级与卸载
已经安装应用后,先保存工作,再查看可升级项目并按需升级指定应用:
zsh
brew outdated --cask
brew upgrade --cask visual-studio-code有些应用自带更新机制,Homebrew 的安装记录可能落后于实际版本。Homebrew 会在能够可靠比较时读取应用版本;无法可靠比较时,通常跳过这类应用。--greedy 会把通常跳过的自动更新应用及没有固定版本号的 cask 纳入升级范围,可能增加下载,按需使用。Homebrew:应用自动更新、Homebrew:命令说明
确认不再需要应用、已经保存工作并备份重要数据后,再单独运行卸载命令:
zsh
brew uninstall --cask visual-studio-code普通卸载可能保留配置和数据;如果还要清理这些文件,可在卸载命令中加 --zap。它也可能删除与其他应用共享的文件,执行前先确认删除范围并备份需要保留的数据。Homebrew:卸载命令
用官方图形界面 BrewUI 管理软件
2026 年 9 月 13 日发布的 Homebrew 7.0.0 公告正式介绍了 BrewUI,即 Homebrew 官方的原生 macOS 图形界面。它把软件浏览、搜索和已安装版本信息集中在窗口中,并显示软件操作对应的 brew 命令,适合希望先用图形界面熟悉包管理的读者。Homebrew 7.0.0:Homebrew app
BrewUI 的项目名、安装名和应用名不同,查找时可以按下面的对应关系核对:
| 项目 | 名称或要求 |
|---|---|
| 官方源码项目 | Homebrew/BrewUI |
| Homebrew Cask 名称 | homebrew-app |
| 安装后的应用 | /Applications/Homebrew.app |
| 系统要求 | macOS Tahoe 26 或更新版本 |
| 本次核查的 GUI 版本 | 0.4.0(2026-09-14 核查) |
以上以官方 Cask 页面和BrewUI 项目说明为准。GUI 有独立的版本号和系统要求:macOS Sequoia 15 上能运行受支持的命令行 Homebrew,并不代表能安装 BrewUI。仍在使用 macOS 15 的读者可以继续按本文的终端步骤管理软件。
安装并打开 Homebrew.app
先完成前文的 Homebrew 安装与 Shell 配置,在「关于本机」中核对 macOS 版本。已有 Homebrew 的用户可先运行下面的命令;其中 brew update 会更新 Homebrew 及软件定义,后两项用于查看版本和应用信息:
zsh
brew update
brew --version
brew info --cask homebrew-app确认应用来源和系统要求后,再安装 GUI。这一步会下载应用并写入应用程序目录:
zsh
brew install --cask homebrew-app安装完成后,在 Finder 的「应用程序」中打开 Homebrew.app。GUI 需要单独安装;仅执行 brew update 更新命令行 Homebrew,不会自动安装这个应用。Homebrew:GUI 安装入口
第一次使用时先浏览和核对
- 查看已安装软件及版本,找一个自己认识的工具,确认能看懂它的名称和用途。
- 搜索
wget或自己需要的软件,阅读详情,再决定是否安装。查询已有软件和浏览可用软件都可以作为第一次练习。 - 需要安装或更新时,先保存相关工作,阅读界面显示的
brew命令和操作输出,核对目标及依赖。完成后重新查看版本;命令行工具也可用自己的版本命令验证。
BrewUI 通过 brew 命令行和 Homebrew 的软件数据提供管理界面,因此仍需理解本文介绍的安装来源、依赖升级和卸载影响。熟悉图形操作后,可以对照它显示的命令学习终端用法。BrewUI:功能与工作方式
如果应用无法读取已安装软件,先回到终端检查 brew --version 和 brew --prefix,再带着具体错误查看官方项目的问题列表。需要更新 GUI 本身时,先退出 Homebrew.app,再按前文的 Cask 升级方式运行 brew upgrade --cask homebrew-app。
撤回试装与保留维护记录
若 wget 只是本次试装、确认没有其他工作需要它,可用 brew uninstall wget 移除该软件;若出现依赖提示,先停下来阅读,不使用强制参数。卸载不是版本回滚,也不保证清除所有配置和下载数据。Homebrew:卸载命令
不要直接删除 /opt/homebrew 或 /usr/local 来“恢复安装前状态”,这些位置可能包含其他工具。要移除整个 Homebrew,应先清点软件和数据,再按官方卸载说明处理。
练习:只完成环境检查与查询,解释安装路径、目标包用途,以及 update 和 upgrade 的区别。若确实安装了工具,再用它的版本命令验证;已经安装测试工具时,可做一次升级预览,但不必为了完成练习实际升级。保持一份自己安装的软件清单和重要版本记录,后续维护会比记住一串命令更有价值。
如果使用 BrewUI,再选一个软件,对照图形界面的名称、已安装版本与 brew info 输出,确认自己能从两种入口读懂同一份软件信息。
了解其他开源 Homebrew 图形界面
除了前文的官方 BrewUI,也可以按管理对象了解下面三个社区项目。项目链接指向各自的源码仓库,下载入口和系统要求以项目当前说明为准。
| 项目 | 主要用途 | 适合谁与选择时的注意点 | 开源许可证 |
|---|---|---|---|
| Applite | 以应用商店式界面浏览、安装和管理 Homebrew Cask 应用 | 适合主要安装桌面应用的读者;专注 cask,不管理 formula 或后台服务。已有 Homebrew 时可在设置中指定其路径 | MIT |
| WailBrew | 管理 formula、cask、tap(软件仓库)和 Homebrew 后台服务,查看依赖及可用更新 | 适合希望在一个窗口中管理工具和应用的读者;需要先安装 Homebrew,支持中文界面 | MIT |
| Cakebrew | 搜索、安装、卸载和升级 formula,管理 tap,并提供 Homebrew 更新与清理入口 | 适合主要管理命令行工具、希望使用简单图形界面的读者;项目说明以 formula 管理为主,使用前应查看发布记录及当前兼容性问题 | GPL-3.0 或更新版本 |
如果只是想方便地安装和更新桌面应用,可以先了解 Applite;如果还要管理命令行工具、依赖和后台服务,可以先了解 WailBrew。Cakebrew 则可作为以 formula 管理为主的另一种选择。先选一个符合需求的界面,用熟悉的软件核对名称和版本,再执行安装或升级。
以上功能与许可证已按项目官方仓库核查,未进行本机安装实测。图形界面的系统要求与 Homebrew 自身的支持条件需要分别核对;操作前仍应按本文说明确认升级、卸载及清理的影响范围。