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 是一款让旧 Intel Mac 装新系统的 Python 工具，3.0.0 版本新增了对 macOS Tahoe 的支持。机型在 docs/MODELS.md 名单内的 Intel Mac 可以照做，PowerPC 与 Apple Silicon 机型立刻停手。全流程会写入 EFI 分区并修改系统根卷，动手前先备份数据。
适用对象与红线
| 要求项 | 最低要求 | 不满足的后果 |
|---|---|---|
| 运行 OS | 仅 macOS | Linux 装不出依赖环境，流程无法进行 |
| Python | 3.6+，建议 python.org 官方版（3.11 更佳） | 系统预装或 Xcode 附带 Python 明确不支持 |
| 硬件架构 | Intel Mac，Penryn 及更新 | PowerPC、Apple Silicon 无法运行 |
| 机型白名单 | hw.model见于 docs/MODELS.md 表格 | 构建出的引导配置无法启动，白忙一场 |
| 内存 | 目标为 Sonoma 及更新版本时 3GB 以上 | 2GB 机型装不了 Sonoma/Sequoia，Sequoia 可能无法启动 |
能力边界：只覆盖全新安装与升级两条路，不改固件，接管不了被其他补丁器改过的环境。
⚠️ 写入 EFI 分区与修改根卷均为不可逆操作，备份未完成就不要进入下一步。
一图看懂全流程
核对机型白名单：终端一条命令拿到机型标识，与官方表格比对。克隆仓库并安装依赖：取源码，一条命令装齐全部 Python 依赖。启动主菜单核对硬件检测：确认程序读到的系统版本、机型、GPU 与真实硬件一致。构建 OpenCore 并写入 EFI 分区：生成绑定本机的引导配置并写入目标磁盘。重启出现 OpenCore 选择器：引导器生效，新系统可启动。根补丁重建内核缓存：装完系统后补齐图形等组件，恢复硬件加速。
最小执行路径
核对机型是否在白名单
目标：确认这台 Mac 的机型标识在支持列表内，避免后续白忙。
命令：
sysctl -n hw.model成功信号：终端打印出MacBookPro11,5这类标识，且能在 docs/MODELS.md 表格中查到该行，并能看到该机型对应的可用系统版本区间。查不到就停手，不要继续写 EFI 分区。
💡 该标识与"系统信息"窗口里的Model Identifier相同，可互相印证。
克隆仓库并安装依赖
目标：拿到源码并装齐运行所需的全部 Python 依赖。
命令：
git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-Patcher pip3 install -r requirements.txt成功信号：requirements.txt 只列了 10 个依赖，核心是wxpython、pyobjc、py_sip_xnu。pip 以Successfully installed收尾且无报错；pip3 show wxpython能打印出已安装版本号。出现依赖解析失败，就换 python.org 官方 Python 3.11 重装，不要用系统自带解释器。
启动主菜单核对硬件检测
目标：确认程序正确读到了系统版本、机型标识和 GPU 信息。
命令：
python3 OpenCore-Patcher-GUI.command成功信号：wxPython 主菜单窗口弹出，界面显示检测到的 macOS 版本、Model:后的机型与 GPU 信息，且机型与sysctl -n hw.model输出一致。读到的机型与sysctl不一致，停手检查 Python 环境后重启程序。
💡 同一入口也是命令行工具：加--build直接构建 OpenCore，--model iMac12,2指定目标机型，--hide_picker隐藏启动选择器。
构建 OpenCore 并写入 EFI 分区
目标：生成引导配置，把引导器写进目标磁盘的 EFI 或 FAT32 分区。
⚠️ 生成的配置绑定这台机器：界面里机型选错，写出来的引导配置可能无法启动；动手前确认已备份目标磁盘上的全部数据。
命令：
python3 OpenCore-Patcher-GUI.command --build成功信号：构建结束后按提示选择磁盘与分区，写入完成提示出现，所选分区中出现引导文件；重启后出现 OpenCore 启动选择器。重启后选择器不出现，回本步骤重选分区写入，并在命令后加--verbose拿详细日志排查。
全新装完后打根补丁
目标：全新安装或升级装完后，替换缺失的图形等组件、重建内核缓存，恢复硬件加速。
命令：
python3 OpenCore-Patcher-GUI.command --patch_sys_vol成功信号：界面提示补丁应用完成、内核缓存重建成功；重启后图形加速与音频恢复正常。提示缺少内核调试包（KDK）时，按界面指引下载对应 KDK 后重试。需要回退时运行python3 OpenCore-Patcher-GUI.command --unpatch_sys_vol。
装完自查
| 检查项 | 命令 | 期望输出 |
|---|---|---|
| 引导器是否生效 | nvram -p | 输出中含 OpenCore 引导器版本信息 |
| 图形/运行时 Kext | kextstat | 列表中出现 Lilu、WhateverGreen |
| Wi-Fi 驱动 | kextstat | 列表中出现 AirPortBrcmFixup |
| 图形加速 | system_profiler SPDisplaysDataType | 显卡信息显示加速可用 |
遇到 OTA 大版本更新会重建根卷使根补丁失效，更新完成后重跑一次python3 OpenCore-Patcher-GUI.command --patch_sys_vol即可恢复加速。
高频问题与修复
现象：重启后没进新系统，直接进入旧系统或黑屏。定位：nvram -p输出中读不到 OpenCore 引导器信息，说明引导器没跑起来。处理：重跑python3 OpenCore-Patcher-GUI.command --build，重选磁盘分区写入；仍不出现就加--verbose拿详细引导日志比对。
现象：Wi-Fi 图标灰着，无线网络不可用。定位：kextstat列表里没有 AirPortBrcmFixup，无线芯片在构建时未被识别。处理：重跑--build，让程序重新检测无线芯片后再生成配置并写入。
现象：大版本更新后图形掉回无加速。定位：OTA 重建了根卷，原根补丁失效。处理：一条命令修复，重跑python3 OpenCore-Patcher-GUI.command --patch_sys_vol后重启。更多场景见 docs/FAQ.md。
OpenCore Legacy Patcher 只覆盖全新安装与升级，不改固件，接管不了其他补丁器留下的环境。更多排障条目见 docs/TROUBLESHOOT-MISC.md。
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
