OpenCore Legacy Patcher 3.0.0：老 Mac 装最新 macOS 完整指南
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
OpenCore Legacy Patcher 是让老 Mac 运行最新 macOS 的工具。3.0.0 新增 macOS Tahoe 支持，并改进了无线与非 Metal 补丁。它只支持全新安装与升级两条路，不支持 PowerPC 与 Apple Silicon，接管不了被其他补丁器改过的系统。
写入 EFI 分区前的自查项
全部通过再动手。任何一行不达标，先解决该行，不要开始写入。
| 自查项 | 达标条件 | 不满足的后果 |
|---|---|---|
| 硬件架构 | Intel Mac（Penryn 及更新） | PowerPC 与 Apple Silicon 机型不在支持范围 |
| 机型标识 | sysctl -n hw.model的输出能在 docs/MODELS.md 表格中查到 | 名单外机型无法引导，直接停手 |
| 内存 | 安装 Sonoma 及更新版本需 3GB 以上 | 2GB 机型装不了 Sonoma/Sequoia，Sequoia 可能无法启动 |
| Python | python3 --version返回 Python 3 版本号 | 依赖装不上，程序无法运行 |
| 数据备份 | 重要数据已备份 | 流程会写 EFI 分区并修改系统根卷，数据损失不可挽回 |
⚠️ 整个流程会写入 EFI 分区并修改系统根卷，动手前先把备份做好。
预检：确认机型在名单内并装好依赖
目标
确认这台机器在白名单内、源码环境可用，并且程序读到的硬件信息与终端一致。
操作
sysctl -n hw.model git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-Patcher pip3 install -r requirements.txt python3 OpenCore-Patcher-GUI.commandpip3 install -r requirements.txt一次装齐 10 个依赖，核心是wxpython与pyobjc。最后一条命令启动图形主菜单。
💡 主菜单界面同时是命令行入口：加--build直接构建，加--model iMac12,2指定目标机型，加--verbose打开详细日志。
验收
主菜单窗口弹出，界面显示的 macOS 版本、机型标识与 GPU 信息和sysctl输出一致。判据不成立：回上面的自查表核对机型与依赖，不要进入写入步骤。
写入引导：构建 OpenCore 并写入 EFI 分区
目标
生成绑定本机的引导配置，把 OpenCore 引导器写进目标磁盘的 EFI 分区。
⚠️ 写入会覆盖所选分区内容。界面里机型选错，写出的引导配置可能无法启动。
操作
python3 OpenCore-Patcher-GUI.command --build按提示选择目标磁盘与分区后确认写入。要走全新安装路线，先在界面"Create macOS Installer"菜单里制作引导安装 U 盘，流程见 docs/INSTALLER.md。
💡--hide_picker隐藏启动选择器，--disk直接指定目标磁盘，可跳过图形选择。
验收
写入完成后重启，按住 Option 选择 OpenCore 引导项，出现 OpenCore 启动选择器。判据不成立：回到本步重选磁盘与分区，再加--verbose看日志定位。
装完系统后：跑根补丁恢复图形加速
目标
全新安装或升级完成后，替换系统缺失的图形等组件、重建内核缓存，让硬件加速恢复。
⚠️ 根补丁修改系统根卷。Monterey 及更新版本若打补丁后无法引导，可在恢复模式回退到打补丁前的快照。
操作
python3 OpenCore-Patcher-GUI.command --patch_sys_vol程序检测到根卷处于"脏"状态时会拦截重复打补丁，防止半覆盖补丁引发故障。
验收
界面提示补丁应用完成；重启后用system_profiler SPDisplaysDataType确认显卡加速恢复。判据不成立：先检查引导器是否生效，再回写引导阶段重做；需要回退时运行--unpatch_sys_vol。详情见 docs/POST-INSTALL.md。
启动链条里各组件的分工
- OpenCore 1.0.5：UEFI 阶段把 SMBIOS 伪装成受支持机型，让系统放行这台 Mac。
- Lilu 1.7.1：内核运行时在内存中拦截被移除的符号，只改内存不落盘。
payloads/Kexts/：随包携带 WhateverGreen 1.6.9（图形）、AppleALC 1.6.3（音频）、AirPortBrcmFixup 2.1.9（无线）等 Kext。- RestrictEvents 1.1.7 与 FeatureUnlock 1.1.7：过滤系统事件、解锁被 Apple 关闭的功能。
- 根补丁：装完系统后重建内核缓存、替换根卷框架，把图形加速找回来。
全程不改固件，只动 EFI 分区与系统卷；被其他补丁器改过的环境它接管不了。
装完后的自查：四条命令确认引导、驱动与加速
| 检查项 | 命令 | 期望输出 |
|---|---|---|
| 引导器是否生效 | nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version | 打印当前引导的 OpenCore 版本号 |
| 图形/音频 Kext | kextstat \| grep -iE "lilu\|whatevergreen" | 列出 Lilu、WhateverGreen 条目 |
| Wi-Fi 驱动 | kextstat \| grep -i airport | 列出 AirPortBrcmFixup 条目 |
| 图形加速 | system_profiler SPDisplaysDataType | 显卡信息中显示加速可用 |
常见故障恢复：无法引导、Wi-Fi 灰显、加速丢失
现象：重启后进不了新系统，也没有 OpenCore 选择器。定位：nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version无输出，说明引导器没跑起来，写入目标选错了。处理：重跑python3 OpenCore-Patcher-GUI.command --build，重选磁盘与分区，加--verbose拿日志排查。
现象：Wi-Fi 图标灰着不可用。定位：kextstat | grep -i airport里没有 AirPortBrcmFixup。处理：重跑--build，让程序重新检测无线芯片后再生成配置。
现象：OTA 大版本更新后图形掉回无加速。定位：更新会重建根卷，根补丁随之失效。处理：重跑python3 OpenCore-Patcher-GUI.command --patch_sys_vol一条命令恢复。
现象：打根补丁后卡在启动画面（Monterey 及更新版本）。定位：根卷内混入问题 Kext 导致无法引导。处理：在 OpenCore 选择器上按住空格进恢复模式，终端执行bless --mount "/Volumes/Macintosh HD" --bootefi --last-sealed-snapshot回退到打补丁前的快照，方法见 docs/TROUBLESHOOT-MISC.md。
本文只覆盖全新安装与升级：不改固件，不接管 PowerPC、Apple Silicon 与其他补丁器留下的环境。第一步从机型自查开始，确认sysctl -n hw.model的输出在 docs/MODELS.md 名单里，做完备份再往下走。
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
–逻辑运算符)
