OpenCore Legacy Patcher 3.0.0：手把手让老 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 内核扩展工作，让苹果已停止支持的旧款 Intel Mac 也能安装 macOS Big Sur 直至最新的 Tahoe。它只走全新安装与升级两条路，核心能力是构建自定义 OpenCore 配置写入 EFI 分区，以及对系统根卷打补丁恢复图形加速。3.0.0 新增了 macOS Tahoe 支持，并改进了无线与非 Metal 补丁。

能不能用，先看清硬边界：

• 只支持 Intel Mac（Penryn 架构及更新），机型标识必须在 docs/MODELS.md 白名单里
• PowerPC Mac 与 Apple Silicon 机型一律不支持
• 不支持从 Patched Sur、bigmac 等其他补丁器改过的系统迁移，文件完整性已破坏
• 目标系统为 macOS Big Sur 11.x ~ Sequoia 15.x，Tahoe 为 3.0.0 新增
• 不在白名单里的机器到此为止，别再往下碰 EFI 分区

开始之前：5 项硬性条件逐条过

1. 主机系统为 macOS Yosemite 10.10 或更新 —— 版本过低跑不起补丁器本体，依赖也装不上
2. 从 python.org 官方源安装的 Python 3.6+（3.11 更稳）；若要做 Sonoma 及以上的安装盘，主机还需 High Sierra 10.13+ —— 系统预装或 Xcode 附带的 Python 明确不受支持，createinstallmedia版本不够则建不了新版安装盘
3. sysctl -n hw.model输出的机型标识能在 docs/MODELS.md 中查到 —— 查不到就无法安装，强行写 EFI 只会得到无法启动的盘
4. 装 Sonoma 及以上时内存 3GB+ —— 2GB 机型装不了 Sonoma/Sequoia，Sequoia 甚至可能无法启动
5. 重要数据已用 Time Machine 或 ASR 备份 —— 后续流程会写入 EFI 分区并修改根卷，出错后数据无法找回

⚠️ 全流程会写入 EFI 分区、修改系统根卷，任何一步写错分区都可能让系统无法启动，动任何一条命令前先备份。

跟着做：从机型核验到根补丁跑通

步骤 1｜核对机型是否在支持名单

这一步决定后面所有操作是否值得做：OCLP 靠机型标识匹配内置的 SMBIOS 数据与补丁集，机器不在名单里，生成的引导配置根本起不来。

# 查看本机机型标识，输出形如 iMac12,2 sysctl -n hw.model # 顺带确认系统版本与内存大小 sw_vers

把输出的标识拿到 docs/MODELS.md 的表格里对号，记下该机型对应的系统版本区间和已知问题。✅ 能在表中查到标识并看到可用版本区间，就算通过；查不到就直接停在这一步。

步骤 2｜克隆源码并装齐依赖

补丁器本体是 Python 项目，从源码跑最灵活：依赖不多，一条命令装完，装好后随时可以用 CLI 参数驱动。

git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-Patcher # requirements.txt 共 10 个依赖，核心是 wxpython、pyobjc、py_sip_xnu pip3 install -r requirements.txt

终端以Successfully installed ...收尾且无ERROR，再执行pip3 show wxpython能看到版本号，说明 GUI 依赖就绪。

⚠️ 容易卡住的地方： 现象：pip3 install报编译或版本错误。 解法：换 Python 3.11（python.org 官方源）再装一遍。

步骤 3｜构建 OpenCore 并写入 EFI 分区

这一步生成与本机硬件绑定的 OpenCore 配置，把引导器和 kext 写进目标磁盘的 EFI 分区（或整块写入一个 USB 盘），让老机器能从 UEFI 阶段就伪装成受支持机型。

# 无参数进入 GUI，选 "Build and Install OpenCore" 按提示走 python3 OpenCore-Patcher-GUI.command # 或者命令行直接构建并写入 python3 OpenCore-Patcher-GUI.command --build # 常用参数：--model iMac12,2 指定目标机型 / --hide_picker 隐藏启动选择器 / --verbose 开详细日志

构建过程中核对界面显示的 macOS 版本、机型与 GPU 是否和sysctl一致；随后选择目标磁盘与分区，完成后所选分区的 EFI 目录里出现OpenCore目录及引导文件。

⚠️ 容易卡住的地方： 现象：生成配置里机型与本机不符，或写错磁盘分区，重启后进不了系统。 解法：配置与这台机器绑定，界面里机型选错就重新构建；写前务必确认选中的磁盘与分区，必要时加--verbose拿日志定位。

步骤 4｜制作并启动 USB 安装盘

引导器就位后，还缺一张能装系统的盘：OCLP 会下载官方镜像、格式化 USB 并写入安装文件，得到一块可引导的 macOS 安装盘。

# GUI 主菜单选 "Create macOS Installer"，按提示下载镜像、选 USB 并执行 python3 OpenCore-Patcher-GUI.command

下载阶段界面列出官方产品目录并显示进度；写入完成后，USB 上出现 macOS 安装文件。重启时从 OpenCore 启动选择器选到该 USB，进入安装程序全新安装到你的目标卷。

⚠️ 容易卡住的地方： 现象：镜像目录里找不到目标版本或下载中断。 解法：确认主机满足第 2 节的系统版本要求后，在 GUI 里点重试续传。

步骤 5｜给系统卷打根补丁

全新装完进入桌面后，老机器的图形、音频等驱动缺斤少两：这一步替换根卷里缺失的框架组件并重建内核缓存，把硬件加速写回磁盘，是整条链路里唯一动根卷的一环。

# 对当前系统根卷打补丁 python3 OpenCore-Patcher-GUI.command --patch_sys_vol # 需要回退时执行 python3 OpenCore-Patcher-GUI.command --unpatch_sys_vol

界面显示补丁应用进度，提示完成后重启，图形加速与音频应恢复正常。

⚠️ 容易卡住的地方： 现象：首次运行卡在下载 KDK / MetallibSupportPkg 阶段，只打上 Wi-Fi 相关补丁。 解法：联网后重跑一次--patch_sys_vol补全其余补丁，并确认系统时间设置正确。

它为什么能跑通：3 分钟看懂核心链路

1. OpenCore：启动早期在 UEFI 阶段注入 SMBIOS 伪装并加载 kext，只动内存与配置，不改固件。
2. Lilu：内核扩展的宿主，在内存中补回系统移除的符号，只动内存不落盘。
3. payloads/Kexts/：WhateverGreen、AppleALC、AirPortBrcmFixup 等驱动集合，补齐图形、音频、无线。
4. 根补丁：替换根卷缺失的框架与库并重建内核缓存，是唯一动磁盘的一步，OTA 大版本更新后会失效。

跑通之后：先自查再收工

• nvram -p→ 输出里能看到 OpenCore 引导器版本信息
• kextstat | grep -i lilu→ 列表中 Lilu 已加载
• kextstat | grep -i whatevergreen→ WhateverGreen 在列
• kextstat | grep -i airportbrcmfixup→ Wi-Fi 修复扩展在列
• system_profiler SPDisplaysDataType→ 显卡信息显示加速可用

现象：重启后没进新系统，停在旧启动项。大概率原因：写错了磁盘分区，NVRAM 里找不到引导器。一行修复：python3 OpenCore-Patcher-GUI.command --build --verbose重选分区写入。

现象：Wi-Fi 图标灰着不可用。大概率原因：AirPortBrcmFixup 没加载，无线芯片未被正确识别。一行修复：python3 OpenCore-Patcher-GUI.command --build重新检测无线芯片后再生成配置。

现象：OTA 大版本更新后图形掉回无加速。大概率原因：更新重建了系统卷，根补丁随之失效。一行修复：python3 OpenCore-Patcher-GUI.command --patch_sys_vol。

后续每次大版本更新都要重跑上面的根补丁命令，卸载补丁则用--unpatch_sys_vol；2.5.0 起对"脏根卷"的重复打补丁有拦截。更多条目见 docs/TROUBLESHOOT-MISC.md。

【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher