STM32+W5500网络Bootloader实现：远程固件升级方案与踩坑总结
2026/9/9 18:05:47
OpenCore Legacy Patcher 完整指南：老 Intel Mac 安装新版 macOS 全流程与问题清单
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
如果你的 Mac 是 2012 到 2017 年的 Intel 机型，系统更新已经停摆多年，OpenCore Legacy Patcher（简称 OCLP）可以让它在官方不再支持的硬件上安装并使用 macOS Big Sur 到 macOS Sequoia。本指南覆盖兼容性自查、安装器制作、OpenCore 构建、安装、安装后补丁与排障，全部基于项目仓库内的真实文档与截图。
一、先搞懂它：OCLP 能做什么、不能做什么
OCLP 是一个 Python 项目，构建在 OpenCorePkg 与 Lilu 之上（核心实现见 opencore_legacy_patcher/ 目录）。
原理：OpenCore 是一个启动加载器，它把补丁注入到内存中，而不是改写磁盘上的系统文件。这带来两个直接好处：
- 系统文件保持完整，出问题时可以卸载恢复；
- 大多数机型无需修改固件（APFS ROM 补丁），安装过程更接近原生体验。
能力边界（依据 README.md 与 docs/MODELS.md）：
| 维度 | OCLP 支持情况 | 说明 |
|---|---|---|
| 硬件范围 | 2007 年（Penryn 架构）起的 Intel Mac | PowerPC 与 Apple Silicon 机型不支持 |
| 系统版本 | macOS Big Sur 11 至 macOS Sequoia 15 | 官方仅对 Big Sur–Sonoma 提供完整支持 |
| 安装方式 | 全新安装与升级安装 | 不支持在已被其他补丁工具修改过的 Big Sur 上继续打补丁 |
| 安全特性 | SIP、FileVault 2、.im4m 安全启动 | 需要 root 补丁的机型需适当降低 SIP |
| 图形加速 | Metal 与非 Metal 显卡均有对应补丁 | 非 Metal 老显卡依赖 root patch |
注意：如果目标机型不在 支持型号列表 中，请不要继续后续操作——补丁器不会为未列出的机型工作。
二、兼容性自查：型号、内存与目标系统
动手之前，花十分钟确认三件事。
查型号标识符
打开「系统信息」应用，找到Model Identifier字段（例如MacBookPro11,2、iMac14,2）。再到 docs/MODELS.md 的表格中比对：每一行都标注了该机型在新系统下的已知问题，例如非 Metal 显卡、USB 1.1 限制、触控板手势缺陷等。这些信息能帮你提前判断体验上限。
提示：文档强烈建议先把 Mac 更新到它所能支持的最新原生系统版本，保证固件是最新的，再用 OCLP 越级安装。
内存是硬门槛
macOS Sonoma 及更新版本要求至少 3GB 内存：只有 2GB 内存的机型无法安装 Sonoma / Sequoia，Sequoia 甚至可能无法启动（见 docs/MODELS.md 开头的警告）。内存不足的老机型，建议目标版本定为 Big Sur 或 Monterey。
制作安装器的基础系统要求
OCLP 应用本身在 OS X Yosemite 10.10 或更新系统上即可运行（见 docs/FAQ.md），但制作安装器依赖 Apple 的createinstallmedia工具，有版本门槛：
- 制作Ventura安装器：基础系统至少 El Capitan 10.11；
- 制作Sonoma 及更新安装器：基础系统至少 High Sierra 10.13。
三、工具准备：两种获取方式与安装
获取补丁器
方式一：使用发布包（推荐）
下载官方 Release 中的OpenCore-Patcher.app，直接用 PKG 安装器安装。自 2.3.0 起，官方只通过 PKG 方式分发应用，旧的 app.zip 方式已停止维护（见 docs/TROUBLESHOOT-APP.md）。
方式二：从源码运行
如果你需要跟随最新提交调试，可以从源码运行，命令与要求见 SOURCE.md：
git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-PatcherGUI 的入口脚本是仓库根目录的OpenCore-Patcher-GUI.command，依赖清单在 requirements.txt。
准备一个 U 盘
建议 32GB 起步：较新版本的 Sonoma / Sequoia 安装器加补丁放不进 16GB 的盘（见 docs/INSTALLER.md）。注意制作过程会格式化整个 U 盘，盘内数据会全部清空。
四、安装器到首次启动：一条完整走通的路
这一节把「制作 USB → 构建 OpenCore → 引导安装」连成一条线，全程在 OCLP 图形界面内完成，无需手写任何命令。
制作 macOS 安装器
启动应用后点击Create macOS Installer，选择Download macOS installer，列表中会列出可下载的各版本安装器，选定后等待下载完成：
下载完成后选择刚下载的本地安装器，再选择目标 U 盘。程序会格式化该盘并写入安装程序，写入过程如下（完成后会弹出成功提示）：
注意：如果你要为另一台 Mac制作安装器，务必先在 Settings 里选中目标机型再制作，否则后续的自动 root 补丁会选择错误的硬件配置。
构建并安装 OpenCore
回到主菜单，选择Build and Install OpenCore，应用会自动探测本机硬件（SMBIOS、显卡、网络芯片等）并生成定制的 EFI 配置，构建完成后点击Install OpenCore，选择目标磁盘与 EFI 分区：
OpenCore 配置是硬件专属的：在 A 机器上构建的 EFI 不能直接搬到 B 机器使用，跨机型制作时必须在 Settings 中指定目标型号（见 docs/BUILD.md）。
引导安装 macOS
重启并按住 Option 键，在启动选择器中选择带 OpenCore 图标的EFI Boot项（按住 Control 可同时设为默认启动项）：
进入安装器后按正常流程安装 macOS 即可。提示：部分 Mac Pro / Xserve / 老 iMac 因显卡未刷 VBIOS 看不到启动画面，docs/BOOT.md 提供了通过恢复模式 +bless命令写入默认启动项的替代方案。
五、安装后补丁：显卡加速、WiFi 与 SIP
系统装完只是开始。老机型的显卡、WiFi、蓝牙等功能依赖Post-Install Root Patch（root 补丁），它把驱动类补丁写入磁盘。
Root 补丁覆盖什么
进入应用主菜单的Post-Install Root Patch区域，应用会列出本机适用且尚未安装的补丁并给出状态（补丁集源码位于 opencore_legacy_patcher/sys_patch/patchsets/hardware/，按 graphics / networking / misc 分类，例如 Intel Ivy Bridge 的intel_ivy_bridge.py、AMD Vega 的amd_vega.py）。覆盖内容包括：
- 显卡加速（Metal 与非 Metal 路径）
- WiFi / 蓝牙驱动
- USB 1.1 兼容（Ventura 及更新系统上的老机型）
- T1 芯片（2016–2017 机型）、内置摄像头等
提示：如果在 OCLP 内制作了安装器并选对了机型，root 补丁会在首次启动后自动安装；自动补丁失败或未走 OCLP 流程时，需要在应用里手动触发一次。
部分显卡需要额外软件包
首次打补丁时，OCLP 可能需要联网下载两个包（见 docs/POST-INSTALL.md）：
| 软件包 | 适用机型 | 说明 |
|---|---|---|
| MetallibSupportPkg | Ivy Bridge / Haswell / NVIDIA Kepler，安装 Sequoia 及以上 | 版本必须与当前系统精确匹配 |
| KDK（Kernel Debug Kit） | AMD GCN 显卡（Radeon HD 7000、R9 等）在 Ventura 及以上 | 取与系统版本最接近的版本 |
注意：若打补丁时没有 WiFi，程序可能只先装网络驱动，重启联网后需要再手动跑一次root 补丁补上显卡加速。用有线网口则通常可以一次装齐。
SIP 该怎么设
OCLP 会根据系统与机型自动决定 SIP 档位，大多数情况无需干预（见 docs/POST-INSTALL.md 的 SIP 章节）。经验法则：
- Ventura 及更新：所有非原生支持的机型都需要降低 SIP；
- Monterey：2013 年及以后的机型大多可保持完整 SIP；
- Big Sur：2012 年及以后具备 Metal 的机型可保持完整 SIP。
警告：已经打过 root 补丁的系统，不要尝试把 SIP 重新开满，可能直接破坏当前系统。拿不准就保持默认。
老显卡修好后是什么效果
以 Intel HD 3000 为例，打上显卡补丁后颜色与显示行为恢复正常，修复前后的对比：
六、排障清单：出问题时先查这七条
以下条目整理自 docs/TROUBLESHOOT-APP.md 与 docs/TROUBLESHOOT-MISC.md，按出现频率排序：
- 应用图标在 Dock 弹跳不打开：在终端执行
/Library/Application Support/Dortania/OpenCore-Patcher.app/Contents/MacOS/OpenCore-Patcher直接拉起。 - 制作 USB 时报 "You don't have permission to save"：到「系统设置 → 隐私与安全性 → 完全磁盘访问权限」中为 OCLP 开启授权，重启应用再试（Big Sur / Monterey 在「系统偏好设置」中）。
- 构建 OpenCore 时找不到内置磁盘：新盘未格式化过 macOS 格式时会出现，用磁盘工具创建约 100MB 的 FAT32 分区，或安装 macOS 时整盘格式化。
- "Privileged Helper Tool not found"：特权助手工具缺失，用 PKG 安装器重新安装 OCLP 即可修复；无 WiFi 时用有线网络或换机下载。
- root 补丁报 error code 71（无法解析依赖）：多为网络包（KDK / MetallibSupportPkg）缺失，先联网补齐后再跑一次。
- root 补丁报系统版本不匹配：通常是自动更新在后台悄悄改动了系统卷，关闭自动更新后重新补丁。
- 设置改了没生效：Settings 里的选项必须重新走一遍「Build and Install OpenCore」才会写入 EFI 分区的
config.plist；直接手改config.plist不会被应用识别。
七、长期维护与行动清单
两条必须记住的规则
规则一：macOS 更新会抹掉 root 补丁。每次通过系统设置升级系统后，显卡、WiFi 等 root 补丁都会消失，需要重新运行 Post-Install Root Patch。OCLP 检测到补丁缺失时会主动提醒；跨大版本升级（如 13 → 14）官方更推荐走 U 盘安装器方式，自动补丁流程更可靠。
规则二：关闭自动更新。Apple 的新版自动更新在下载阶段就开始预装、改动系统卷，系统会处于两个版本之间的中间状态，轻则补丁不匹配，重则系统损坏（见 docs/FAQ.md）。更新系统前先到 docs/UPDATE.md 按流程准备 OCLP。
装完之后的顺手优化
- 不想每次看到 OpenCore 启动选择器：在 Settings 里取消勾选 Show OpenCore Bootpicker 后重建 EFI，之后按ESC键可临时呼出选择器（见 docs/POST-INSTALL.md）；
- 老显卡（非 Metal 路径）上适当关闭多余特效、降低窗口动画，可明显提升流畅度；
- 需要卸载时，参考 docs/UNINSTALL.md 走完整恢复流程。
行动清单
- 在「系统信息」中记下 Model Identifier，并与 docs/MODELS.md 比对
- 确认内存 ≥3GB（若目标是 Sonoma/Sequoia），并先把系统更新到该机型支持的最新原生版本
- 备份全部数据，准备 32GB U 盘
- 安装 OCLP 应用，按「制作安装器 → 构建并安装 OpenCore → Option 键引导」顺序执行
- 安装完成后运行 Post-Install Root Patch，按提示补齐 KDK / MetallibSupportPkg
- 关闭系统自动更新；每次系统更新后重新打一次 root 补丁
按这个流程走完，一台停更多年的老 Intel Mac 就能稳定跑在当前的 macOS 上，而系统文件本身始终保持原样。
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考