Homebrew 是什么怎么用：2026 Mac 新手入门
Homebrew 是帮助 Mac 用户通过命令安装和管理开发工具的软件包管理器。新手不必拿到 Mac 就立刻安装；但如果课程需要 Git、Python、Node.js 等工具，建议按官方方式安装，先完成版本和路径验收，再学习少量常用命令。没有本地 Mac 的学生，也可以在具备完整权限的真实远程 Mac 环境中练习。
这篇文章适合第一次打开 Mac 终端、分不清 Homebrew、brew 和软件包的学生。
如果只有 Windows 或学校公共电脑，又想熟悉标准 macOS 开发环境，也可以从后面的环境判断开始。
Homebrew 是什么怎么用：先判断是否真的需要
Homebrew 可以理解为 Mac 上的“软件包管理员”。
应用商店更像一个展示软件的货架，适合手动点击安装图形应用。Homebrew 则像一位统一的工具管理员：输入一条命令，它负责查找软件、下载所需文件、处理依赖，并把工具放到系统能找到的位置。
brew 是 Homebrew 的命令行入口。例如：
brew install git
这里的 brew 是管理员，install 是动作，git 是要安装的软件包。
Homebrew 适合以下学习任务：
- Python 课程需要命令行运行环境；
- 前端课程需要 Node.js、npm 或 Git；
- 项目要求使用某个终端工具；
- 想统一查看、更新和卸载开发工具。
但以下情况可以继续使用官方安装器：
- 只安装一个常用图形应用；
- 软件开发者明确要求从官网下载安装；
- 课程要求完整 Xcode；
- 学校电脑禁止修改系统环境；
- 当前只是学习 Finder、浏览器或基础办公。
Homebrew 不是 Xcode。它不会替代 Xcode，也不会让 Windows 原生运行 macOS 软件。Homebrew 需要运行在 macOS 或其他受支持环境中；本文讨论的是 Mac 上的使用方式。
⚠️ 如果课程只给出
brew install，却没有说明软件来源，先不要盲目复制。先确认工具名称和课程要求，再查看 Homebrew 官方文档 或软件开发者的安装说明。
Terminal 与图形安装器：第一次使用前先准备
Terminal 是 macOS 的命令行窗口。它不是“黑客工具”，而是让用户用文字调用系统程序的入口。Apple 的 Terminal 用户指南 介绍了窗口、shell、命令和输出之间的关系。
打开路径通常是：
启动台 → 搜索 Terminal → 打开。
也可以在 Finder 中进入“应用程序 → 实用工具”，双击 Terminal。
看到类似下面的内容时，最后的 % 通常就是当前输入位置：
student@MacBook ~ %
不要复制这一行提示符，只复制命令本身。例如：
uname -m
执行后可能返回：
arm64
或：
x86_64
这一步用于识别芯片架构。arm64 通常代表 Apple Silicon，x86_64 通常代表 Intel。不要根据 Mac 外观猜芯片类型，因为同一外观可能对应不同硬件。
按当前 Homebrew 官方安装要求，安装前需要检查处理器架构、受支持的 macOS、网络和管理员权限，并准备 Xcode Command Line Tools 或完整 Xcode。当前官方页面列出的最低 macOS 要求是 macOS Sonoma 14；系统支持范围如果发生变化，应以安装当天的官方页面为准。
完整 Xcode 不是 Homebrew 的前置条件。普通 Python、Git 或前端课程，通常先准备 Command Line Tools 即可。可以在 Terminal 输入：
xcode-select --install
如果系统弹出安装窗口，阅读内容后选择继续。若系统提示 Command Line Tools 已经安装，不需要重复操作。若学校电脑没有管理员权限，安装窗口无法继续时应停止，不要自行添加 sudo 绕过限制。
安装 Homebrew 时，使用官方安装文档提供的命令：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
运行前注意 4 件事：
- 只复制代码，不要把前面的提示符一起复制；
- 确认命令来自 Homebrew 官方页面；
- 安装器会先显示准备执行的动作，先阅读再确认；
- 如果显示无法连接、权限不足或路径异常，不要连续重复执行，先保留完整输出。
PATH 与安装路径：完成第一轮验收
安装器结束时，通常会给出一段配置 shell 环境的命令。shell 可以理解为 Terminal 背后的“命令解释员”，而 PATH 就像系统的地址簿：系统会按地址簿寻找 brew、git 或其他可执行工具。
如果只安装 Homebrew，却没有执行安装器最后提示的 shell 配置步骤，常见结果是：
zsh: command not found: brew
此时不要马上重装。先回到安装输出，找到类似 brew shellenv 的提示，并按当前窗口显示的命令执行。Apple Silicon 和 Intel Mac 的路径不同，不能随意把网上的路径互换。
Homebrew 官方默认路径如下：
| Mac 类型 | 默认 Homebrew 路径 | 主要意义 |
|---|---|---|
| Apple Silicon | /opt/homebrew |
适配 M 系列芯片的默认安装位置 |
| Intel Mac | /usr/local |
适配 Intel Mac 的默认安装位置 |
默认路径信息以 Homebrew 官方安装文档 为准。不要为了照抄教程，强行把 Apple Silicon 的配置写到 /usr/local，也不要把两个架构的配置混在一起。
完成 shell 配置后，关闭当前 Terminal，再打开一个新窗口。然后依次运行：
brew --version
brew --prefix
brew doctor
三条命令分别解决不同问题：
brew --version：确认系统能调用 Homebrew；brew --prefix：显示实际安装目录；brew doctor：检查常见环境问题。
正常表现是第一条返回版本信息，第二条返回对应默认路径，第三条没有阻断安装的问题。具体命令含义可以对照 Homebrew brew 手册。
如果 brew --version 找不到命令，优先检查：
- 是否执行了安装器最后给出的 shell 配置；
- 是否重新打开了 Terminal；
- 当前 Terminal 是否使用了不同架构的 shell；
- 是否存在旧的
/usr/local与新的/opt/homebrew混用。
不要直接把两个目录都写进配置文件。先运行：
brew --prefix
如果该命令本身无法执行，再回看安装器最后输出，而不是随意编辑 .zshrc 或 .zprofile。
第一个工具：用 tree 完成安装闭环
为了建立完整闭环，适合新手演示的工具是 tree。它可以把文件夹内容按树状结构显示，安装后容易测试，也容易卸载，不会改变 Python 或前端项目本身。
先搜索：
brew search tree
再查看信息：
brew info tree
确认名称无误后安装：
brew install tree
安装完成后测试：
tree --version
也可以进入一个练习文件夹，再运行：
tree
Homebrew 的软件对象主要分为两类：
- formula：通常是命令行工具、库或开发依赖，例如
tree、git； - cask：通常是图形应用或预编译应用包。
命令行工具一般使用：
brew install 软件名
图形应用可能使用：
brew install --cask 软件名
不过，图形应用是否适合通过 cask 安装，仍应查看软件开发者和 Homebrew 的对应说明。不要为了练习命令，随意添加第三方 tap 或执行不明脚本。
下面的决策表可以帮助新手选择安装方式：
| 学习任务 | 优先方式 | Homebrew 的作用 | 需要留意的边界 |
|---|---|---|---|
| 学 Python 基础 | 按课程要求准备 Python | 可管理部分开发工具 | 课程若要求特定版本，不要盲目升级 |
| 学前端 | 按项目要求准备 Node.js、Git | 方便安装和更新命令行工具 | 项目依赖仍应记录在项目文件中 |
| 安装终端工具 | 先搜索和查看信息 | 统一管理 formula | 先确认名称，避免装错同名软件 |
| 安装图形应用 | 优先查看开发者安装方式 | 可处理部分 cask | 应用自身更新器可能独立运行 |
| 学 Xcode | 使用 Apple 官方渠道 | 不把 Xcode 当作 formula | Homebrew 不能替代 Xcode |
真实学习中，最容易出现的问题不是命令太难，而是把“安装成功”误认为“课程环境已经正确”。例如 brew install python 成功，并不代表项目一定使用了这个 Python。还需要结合课程要求检查：
which python3
python3 --version
如果项目使用虚拟环境，还应在项目目录中单独创建和激活虚拟环境，避免不同课程的依赖互相干扰。
第一周管理工具：更新、查看与卸载
新手不需要一次背下所有命令。记住“更新资料、查看状态、升级软件、卸载对象”这条线即可。
brew update
它更新 Homebrew 和软件包信息。
brew outdated
它列出可以升级的已安装软件。
brew upgrade
它升级过期的软件包。课程项目进行到一半时，不建议毫无计划地升级全部工具。若项目对版本敏感，应先保存当前版本和依赖清单。
查看已安装的 formula：
brew list
查看已安装的 cask：
brew list --cask
卸载刚才的测试工具：
brew uninstall tree
卸载前先看终端提示。如果某个软件被其他工具依赖，不要直接加 --force。强制参数适合明确知道后果的情况，不适合作为“命令报错后的下一步”。
Homebrew 的升级、卸载、清理和诊断命令都可以在 官方 FAQ 中核对。新手不需要每天清理缓存，先确保课程项目能够正常运行。
安全习惯比多记几条命令更重要：
- ✅ 先读完终端输出，再输入下一条命令；
- ✅ 记录软件名称、版本和来源；
- ✅ 优先使用默认安装路径；
- ❌ 不要为了“成功”随意添加
sudo； - ❌ 不要执行来源不明的
curl ... | sh脚本； - ❌ 不要在不清楚作用时使用
--force、--zap或删除整棵目录。
如果要换电脑，或使用临时远程环境，可以在项目目录保存软件清单：
brew bundle dump --file=./Brewfile
这会生成一个 Brewfile，记录已安装的 formula、cask 等依赖。Homebrew 的 Brewfile 文档 说明了如何导出和恢复这类环境清单。
按学习条件选择本地 Mac 或远程环境
可以按下面的条件分支选择下一步：
- 若已有本地 Mac，并且拥有管理员权限：按本文流程准备 Command Line Tools，完成 Homebrew 安装、路径检查和
tree测试。 - 若学校 Mac 禁止安装软件：不要尝试绕过权限。把项目依赖记录下来，改用个人设备或具备完整权限的临时环境。
- 若只有 Windows，但课程需要 macOS 工具：不要把 Homebrew 当成 Windows 安装包。应在真实 Mac 的 Terminal 中练习。
- 若只是学习 Python 基础，暂时不需要 macOS 工具：先使用现有电脑学习变量、函数、文件和调试，等课程真正需要 macOS 时再切换环境。
- 若需要反复重置环境：选择可以独立管理、拥有必要权限的 Mac 环境，并保存
Brewfile，避免每次从头猜命令。
如果使用 ProxyMac 的远程 Mac，可以先阅读远程 Mac 登录帮助，确认连接方式、账号权限和 Terminal 的打开位置。首次登录后，仍应按照本文的版本、路径和 brew doctor 验收标准自行检查，不要把“能远程看到桌面”误认为“开发环境已经准备好”。
完成后，入门验收标准只有 3 件事：
- 能在 Terminal 中调用
brew； - 能安装并运行一个测试工具；
- 能用
brew uninstall清理它。
新手常见问题
Homebrew 是否收费？
Homebrew 本身是免费使用的软件包管理工具。需要注意的是，通过它安装的软件可能有各自的授权条款，远程 Mac 或云端 Mac 环境则可能产生设备使用费用。是否安装 Homebrew，应该根据课程依赖决定，而不是把它理解成必须购买的服务。
Homebrew 会替换 macOS 自带软件吗？
正常使用 brew install 不等于替换 macOS 系统组件。Homebrew 会把软件安装到自己的目录中，再通过 PATH 让 Terminal 找到它。涉及系统目录、权限或强制覆盖的命令，不适合新手直接执行。
关闭 Terminal 后，已经安装的工具还能用吗？
可以。关闭 Terminal 只会结束当前命令行窗口，不会自动卸载 Homebrew 或已安装的软件。下次重新打开 Terminal 后，只要 PATH 配置正确，仍然可以运行 brew 和已安装的工具。
Homebrew 安装失败后，可以重复运行安装命令吗？
不建议立即重复。先保存完整报错，检查网络、权限、Command Line Tools 和 PATH。若终端已经显示安装目录或部分完成信息，盲目重装可能制造重复配置。应先对照官方安装文档判断当前处于哪一步。
可以用 Homebrew 安装 Python、Node.js 和 Git 吗？
这些工具通常可以通过 Homebrew 管理，但课程可能要求特定版本或特定安装方式。安装前先看课程说明；安装后再用版本命令确认结果。项目需要稳定依赖时，应保存版本信息和 Brewfile，不要只记住一条安装命令。
如果只有 Windows，或学校电脑不允许安装软件，购买 Mac 可能会把预算锁在一台暂时不确定是否长期需要的设备上。虚拟机还会增加系统兼容、磁盘占用和图形性能限制；公共电脑则常常缺少管理员权限，无法稳定保留 Homebrew 配置。此时，租用 ProxyMac 的真实远程 Mac 更适合先完成课程验证：需要时连接，拥有独立环境，项目结束后即可停止使用。若长期运行大型项目、依赖物理接口，或每天需要离线使用，购买本地 Mac 仍然更合适；若只是临时学习和测试，则可以先查看 ProxyMac 的 Mac 租赁方案，再决定是否投入硬件成本。
