截至 Homebrew 官方安装文档当前列出的要求,macOS 15 及以上版本属于支持范围,Apple silicon 是主要支持配置;Intel Mac 属于较低支持等级。Homebrew 远程 Mac 安装可以按官方说明完成,但要先核对系统和设备权限,再判断课程工具是否需要开发工具;安装后按提示配置终端并验证,不必默认安装完整 Xcode。(Homebrew 官方安装要求)
第一次使用远程 Mac、要为课程准备开发工具的学生,可以跟着步骤完成安装和基础验收。
已经安装 Homebrew、只是终端找不到 brew 的读者,应改看专门的路径排查指南。
学校管理的设备,先确认是否有权安装软件;不要尝试绕过设备管理。
[ SECTION_01 ] 动手前:确认终端连的是远程 Mac
Homebrew 是用来安装和管理开发工具的软件包管理器。可以把它想成课程工具箱的管理员:它负责查找、下载和安装工具,但不会自动判断课程到底需要什么。
如果学生使用 Windows 电脑,首先要分清两个终端:本地 Windows 的命令提示符或 PowerShell,不等于远程 Mac 的“终端”。只有在远程桌面打开 Mac 上的终端,或通过获准的远程连接进入 Mac shell 后,输入的命令才会在那台 Mac 上运行。把安装命令粘贴到本地 Windows 终端,不会因此安装到远程主机。
在远程 Mac 上打开“关于本机”,记录 macOS 版本和芯片类型,再确认当前账号是否有权按页面提示安装软件。Homebrew 官方文档说明了当前系统与硬件要求;这些要求会随文档更新,旧教程中的版本信息不能代替当前页面。(Homebrew 官方安装文档)
Homebrew 官网提供当前的官方安装入口。请从该入口进入安装说明,再在远程 Mac 的终端中执行页面提供的方法。安装器会先显示计划进行的操作,并要求确认;遇到权限、设备管理或系统兼容提示时,应先暂停核实,不要运行来源不明的脚本。(Homebrew 官方安装入口)
[ SECTION_02 ] 安装前:区分 Homebrew 与课程开发工具
安装 Homebrew,与安装某个课程软件,是两件不同的事。不必为了安装 Homebrew 默认下载完整 Xcode。关键在于课程工具能否使用已经编译好的版本,还是必须在这台 Mac 上从源代码构建。
Homebrew 把可直接下载使用的预编译软件包称为 bottle。若某个套件提供适用于当前系统和芯片的 bottle,安装时通常会直接使用;如果课程任务要求从源代码构建,则应根据 Homebrew 当前说明准备 Xcode Command Line Tools(CLT)或 Xcode。具体套件也可能有自己的要求,因此要先查课程文档和该工具的官方说明,再决定需要准备什么。(Homebrew 关于预编译软件包的说明)
安装 Homebrew 前,是否需要先装完整 Xcode?不一定。使用适配当前系统的预编译软件包时,通常不必先装完整 Xcode;需要从源代码构建的套件,则可能需要 CLT 或 Xcode。完整 Xcode 和 CLT 不是同一套安装包,也不要把“某些任务需要开发工具”理解成“所有安装都必须先装完整 Xcode”。(Homebrew 支持等级与开发工具说明)
[ SECTION_03 ] 按时间顺序完成安装与终端配置
下面按准备、安装、配置、验证的顺序操作。每一步都要确认正在使用远程 Mac 的终端,而不是本地 Windows 终端。
-
核对系统和账号。在远程 Mac 上查看系统版本与芯片类型,对照 Homebrew 官方安装页的要求。再确认账号有权安装软件;条件不符合或权限不清楚时,先暂停并询问设备管理员。
-
确定课程需要的工具。查看课程说明,记下必需的软件名称和安装方式。确认工具是否需要从源代码构建,以及课程是否要求图形界面。先做这一步,可以避免为暂时用不到的工具准备整套开发环境。
-
从官方入口发起安装。在远程 Mac 的终端中打开 Homebrew 官方安装入口,使用页面当前提供的安装方法。逐项阅读安装器准备执行的操作,再决定是否继续。遇到无法解释的权限请求、系统不兼容提示或学校管理阻止时,不要强行安装,也不要改用第三方脚本。
-
按安装器提示配置 shell。shell 可以理解为终端接收并解释命令的环境。安装器可能会提示将 Homebrew 加入 shell 配置文件,让新开的终端也能找到
brew。照着这台设备的安装器提示操作,不要照抄旧教程里的固定路径。官方说明介绍了如何依据安装位置把 Homebrew 加入 shell 环境。(Homebrew 的 shell 配置说明) -
验证命令和安装位置。新开一个终端窗口,运行以下命令:
sh
brew --version
brew --prefix
command -v brew
第一条用于确认终端能调用 Homebrew;第二条显示安装前缀;第三条显示当前终端实际找到的命令位置。Apple silicon 的默认安装前缀为 /opt/homebrew,Intel Mac 的默认前缀为 /usr/local;如果安装器为当前设备给出不同提示,应以实际安装方式为准。以上命令的用途和默认路径可在 Homebrew 命令参考中核对。(Homebrew 命令参考)
怎样判断 Homebrew 已经装好?不要只看安装器是否显示完成。终端能运行 brew --version,并能显示安装前缀和命令位置,说明当前 shell 已找到 Homebrew。若终端只提示找不到命令,不要急着重复安装;应转向专门的路径排查说明。
- 按课程要求逐项安装。先确认课程要求的工具名称,再查看该工具的官方说明。若想先了解 Homebrew 中某个工具的信息,可运行
brew info 工具名称;确认它适合课程后,再按课程要求安装。Homebrew 的查询说明介绍了如何查看套件资料。命令可用只代表包管理器已能运行,不代表课程软件已经安装或一定兼容。(Homebrew 查询命令说明)
[ SECTION_04 ] 学校设备和不同路线的取舍
学校管理的 Mac,学生应先自行安装还是联系管理员?先查看学校设备规则和当前账号权限。学校允许自行安装时,再按官方安装器提示操作;需要管理员批准时,应提交申请或请管理员部署。Homebrew 的管理员文档介绍了由管理人员部署以及使用非管理员账户的方式,但这不代表普通学生可以绕过学校策略。(Homebrew 管理员文档)
下面的对照表帮助判断下一步。适配度是按官方要求和学生使用场景整理的判断,不代表性能测试或安装成功率。
| 检查项 | 符合时怎么做 | 不符合时的处理 | 适配度 |
|---|---|---|---|
| 终端位置 | 已打开远程 Mac 的终端,再继续 | 返回远程桌面确认连接,不在 Windows 本机执行 Mac 命令 | 高 |
| macOS 与硬件 | 对照 Homebrew 当前安装页核实 | 暂停安装,询问环境管理员或选择符合要求的设备 | 高 |
| 安装权限 | 账号可按安装器提示操作 | 遇到拒绝或管理员授权要求时申请批准,不绕过策略 | 高 |
| 课程工具要求 | 已查明套件是否需要从源代码构建 | 先查该工具的官方说明,再决定是否准备 CLT 或 Xcode | 高 |
| 后续任务类型 | 是否通常需要开发工具 | 先做什么 | 判断依据 |
|---|---|---|---|
| 安装可用的预编译软件包 | Apple silicon 上通常不必先准备 CLT | 确认当前系统和芯片有适配的软件包 | Homebrew 的 bottle 说明 |
| 从源代码构建套件 | 需要按要求准备 CLT 或 Xcode | 核对 Homebrew 安装说明及课程要求 | Homebrew 的系统要求 |
| 安装课程指定的图形应用 | 取决于应用及安装方式 | 查应用要求,并确认远程 Mac 能使用所需图形界面 | 课程与应用文档 |
| 选择路线 | 主要优点 | 需要留意的限制 | 学生场景评分 |
|---|---|---|---|
| 在获准的远程 Mac 终端安装 | 命令直接作用于 macOS 环境,适合准备 Mac 课程工具 | 依赖网络、远程会话和账号权限 | 很适合 |
| 只在 Windows 本机终端操作 | 适合 Windows 本地课程任务 | 不会把 Homebrew 安装到远程 Mac,也不能代替 Mac 终端 | 不适合本教程 |
| 在学校管理的 Mac 上自行安装 | 学校开放权限时可以使用现有设备 | 管理策略可能阻止安装或要求管理员批准 | 需先确认 |
| 购买并维护自己的 Mac | 设备由本人控制,适合长期持续使用 | 需要承担购置与日常维护成本 | 视预算与使用周期 |
Homebrew 将 Intel Mac 列为 Tier 3 配置;这反映的是支持等级,不等于每个套件都无法运行。若远程环境的芯片或系统版本与课程文档不一致,应先核对课程工具的兼容要求,再决定是否继续安装。(Homebrew 支持等级说明)
[ SECTION_05 ] 用课程任务做最终验收
安装验收不止是看到版本号。学生可以依次确认:brew --version 有输出;brew --prefix 与安装器提示一致;课程要求的工具名称和系统条件已经核对。若课程需要 Xcode、模拟器或图形界面,还要单独确认远程 Mac 是否满足使用条件。Homebrew 不会自动提供这些课程环境。
如果课程项目是 Python,可以先查看在 Mac 上准备 Python 课程环境相关的入门内容,再根据课程指定版本安装,不要为了测试 Homebrew 而随意添加工具。需要了解远程 Mac 学习环境时,可查看 NOVAKVM 的 Mac 环境方案;实际可用系统、访问方式和软件权限,应以对应方案说明及服务交付信息为准,本文不对未核实的环境配置作承诺。
如果当前做法是在 Windows 本机操作,终端就不是 macOS;如果依赖学校设备,安装权限可能受管理策略约束;如果购买个人 Mac,则需要承担购置和维护成本。课程确实要求 macOS、手边又没有可用 Mac 时,可以比较自购与临时远程环境,再查看 NOVAKVM 的远程 Mac 入口了解可选方案。短期课程练习可以先评估租用环境,避免为了单次任务购置整台设备;长期高强度使用或依赖本地物理接口时,则应先判断租用是否适合实际需求。