OpenCore Legacy Patcher 完整新手教程:让 Intel 老 Mac 装上最新 macOS
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
OpenCore Legacy Patcher(OCLP)是一个 Python 项目,基于 OpenCore 引导器与 Lilu 内核补丁框架,把 Apple 已放弃的 Intel 老 Mac 重新拉回 macOS Big Sur 至 Tahoe 的支持范围,并恢复图形加速、Wi-Fi 与音频等功能。本教程按“装好依赖 → 确认机型 → 构建写入 → 引导安装 → 根补丁”五段走一遍,从零到可用约 60~90 分钟。如果你的机器是 Apple Silicon(M 系列芯片)、PowerPC 机型,或机型不在 docs/MODELS.md 的表格里,看到第二节就该停手,后面的操作会向你的磁盘写入数据。
① 动手前自查:4 项硬门槛
下表全部通过才继续,任何一条不满足都说明这条路走不通:
| 检查项 | 要求 | 确认方式 |
|---|---|---|
| 芯片 | Intel 芯片 Mac,Penryn(2008)及更新 | 系统信息 → Model Identifier 查 docs/MODELS.md |
| 内存 | 装 Sonoma 及以上需 3GB+,2GB 机型出局 | 关于本机查看内存 |
| 当前系统 | 补丁器应用要求 OS X Yosemite 10.10+;做 Sonoma 安装盘需 High Sierra 10.13+ | 关于本机查看版本号 |
| Python | 3.6+,且必须来自 python.org 官方源;Xcode 自带或系统预装 Python 不受支持 | python3 --version |
风险照实说:OCLP 会写两个地方——EFI 分区(OpenCore 引导文件、config.plist、kext)和根卷(替换框架、重建内核缓存)。最坏情况是重启后无法进入系统,数据还在盘上但机器变砖,只能用安装介质重装救回。唯一可靠的回退路径是操作前做的 Time Machine 或全盘克隆,建议预留 20 分钟完成这一步,没有第二次机会。官方也建议先把 Mac 更新到它支持的最新原生系统,确保固件版本最新。
② 操作主线:五个阶段
2.1 安装依赖,跑通源码
目标:在本地拿到可运行的 OCLP 工具链。
操作(约 3 分钟):
git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-Patcher pip3 install -r requirements.txt完成标志:pip 依次装完 requirements.txt 里的 10 个依赖(requests、wxpython、pyobjc、py_sip_xnu 等),退出码为 0,无 ModuleNotFoundError。装包报错时,按 SOURCE.md 的建议改用 Python 3.11 重试;仍失败说明 Python 来源不对,回 python.org 重装。
2.2 对照支持表确认机型
目标:确认这台机器能不能装、装出来会缺什么。
操作:在终端执行
sysctl -n hw.model完成标志:输出一行机型标识,例如iMac14,2。拿它去 docs/MODELS.md 搜索:能查到,且表格 "Additional info" 列列出的图形(non-Metal / Legacy Metal)或 USB 1.1 问题你可以接受,就继续;查不到,停手,不要写入任何分区。
⚠️ 构建出的 OpenCore 配置与机型硬件绑定。给别的机器构建时若没在设置里选中目标机型,写出的配置无法启动,只能重选机型重跑构建。
2.3 构建 OpenCore 并写入 EFI 分区
目标:生成绑定本机硬件的引导配置,写进目标磁盘的 EFI 分区。
操作:若做全新安装,先按 docs/INSTALLER.md 用 OCLP 的 Create macOS Installer 功能下载系统镜像并写入 U 盘(建议 32GB,Sonoma/Sequoia 后期版本在 16GB 盘上放不下)。然后启动应用:
python3 OpenCore-Patcher-GUI.command主菜单会直接显示检测到的系统版本与硬件信息:
选择 Build and Install OpenCore 开始构建,构建结束后选择 Install OpenCore,再依次选定目标磁盘与分区(USB 盘需为 GUID/GPT 或带 FAT32 分区)。过程见 docs/BUILD.md。
完成标志:界面提示构建与写入完成,所选分区中出现引导文件。重启后终端执行nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version能打印 OpenCore 版本号(当前打包版本 1.0.5),说明引导器已在运行。
💡 不想开界面可走 CLI:python3 OpenCore-Patcher-GUI.command --build --model iMac12,2 --verbose,-h查看全部参数。
2.4 用 OpenCore 引导并安装 macOS
目标:让安装器看到一台"受支持的机器",完成系统安装。
操作:重启时按住Option键进入 Mac Boot Picker,选择带 OpenCore 图标的 EFI Boot 条目(多按Control可将其设为默认引导项),随后从安装器正常安装 macOS。流程见 docs/BOOT.md:
完成标志:能正常启动进安装器并完成系统安装,首次重启后进入新系统桌面。若重启后停在 picker 或 nvram 读不到版本号,多半是分区选错或写入中断,回到 2.3 重新写入。
2.5 应用根补丁,找回图形加速
目标:新系统缺少老 GPU 对应的图形框架,根补丁负责替换框架并重建内核缓存,不打补丁就只有软渲染。
操作(在新系统里执行,约 10~20 分钟):
python3 OpenCore-Patcher-GUI.command --patch_sys_vol完成标志:补丁列表全部应用、内核缓存重建成功,界面显示完成状态;重启后图形加速与音频恢复。说明见 docs/POST-INSTALL.md。
⚠️ 两个方向都会失效:大版本 OTA 更新会重建根卷、补丁跟着失效,重跑同一命令即可;反过来,根卷处于脏状态时 OCLP 会拒绝打补丁(报 System version mismatch),需先按排障文档修复脏状态。
③ 跑通验证:5 条验收命令与排障
新系统内依次执行,全部符合预期才算跑通:
nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:opencore-version→ 打印 OpenCore 版本号nvram 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:OCLP-Version→ 打印 OCLP 补丁器版本kextstat | grep -i lilu→ 出现 Lilukextstat | grep -i airport→ 出现 AirPortBrcmFixupsystem_profiler SPDisplaysDataType→ Graphics Acceleration 为 Yes
| 症状 | 最可能原因 | 处置 |
|---|---|---|
| 重启进不了系统,nvram 无 opencore-version | OpenCore 未写入正确分区或写入中断 | 回 2.3 重选分区写入,用diskutil list核对磁盘 |
| Wi-Fi 图标灰色,kextstat 无 AirPortBrcmFixup | 无线芯片未识别、驱动未加载 | 回 2.3 重建让 OCLP 重新检测无线芯片;2007–2017 机型走 legacy Wi-Fi 补丁集 |
| 大版本 OTA 后图形加速消失 | 根卷被 OTA 重建,根补丁失效 | 重跑--patch_sys_vol |
| 根补丁报版本不匹配而拒绝运行 | 根卷处于脏状态 | 按 docs/TROUBLESHOOT-APP.md 修复后再打 |
④ 原理速览
OCLP 不改固件、不动硬件,功能分三层接力实现。UEFI 层:OpenCore 在引导阶段经 config.plist 注入受支持机型的 SMBIOS 标识,安装器因此只看到一台"新机器"。内核层:Lilu 在内存中拦截并改向新系统移除的符号,只改内存不落盘;--patch_sys_vol则在磁盘侧替换根卷里需要修补的框架并重建内核缓存。驱动层:WhateverGreen、AppleALC、AirPortBrcmFixup、NVMeFix 等 kext 随 payloads/Kexts/ 打包进系统,随内核加载生效。
⑤ 边界与延伸
- 不支持 PowerPC 与 Apple Silicon 机型;docs/MODELS.md 之外的机型一律不支持。
- 只支持全新安装和升级。已被其他补丁器(Patched Sur、bigmac 等)打补丁的 Big Sur 无法使用,APFS 快照与 SIP 的文件完整性已被破坏;可以重装系统保留数据。
- Mojave 及更老系统不在支持范围,README 推荐 dosdude1 的补丁器。
- 不做任何固件修改(无 APFS ROM patching);官方建议关闭自动更新,避免更新中途把系统卷改到半新半旧的状态。
深入阅读:docs/FAQ.md(应用要求、OTA 说明)、docs/TROUBLESHOOT-MISC.md(引导与安装排障)、docs/PATCHEXPLAIN.md(补丁原理),补丁器主入口在 opencore_legacy_patcher/。
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考