QT+OpenGL（3）：FBO离屏渲染
2026/10/16 3:13:44
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（OCLP）是让旧 Intel Mac 安装并运行 Big Sur 及更新系统的 Python 工具。3.0.0 新增 macOS Tahoe 支持、改进无线与非 Metal 图形补丁、恢复 macOS 26 上的 FileVault 2。手上有 2015 年前后的旧机、能读命令行、愿意先备份的人，照着走。
动手前判断：能不能干，值不值得干
花 10 秒过一遍这些硬条件，有一条不满足就别往下走：
- 硬件门槛：目标机器必须是 Intel 芯片，Penryn（2007）及更新。Apple Silicon、PowerPC 机型直接排除，没有商量
- 软件依赖：Python 3.6+（必须从 python.org 官方源装，Xcode 自带的那个不被支持）+ pip。requirements.txt 里是 wxpython、pyobjc、py_sip_xnu 这类 macOS 专属包，Linux/Windows 上跑不了源码
- 内存门槛：装 Sonoma 及更新系统要 3GB 以上内存，2GB 机型装不了
- 时间预估：从克隆仓库到首次启动，约 30～60 分钟，取决于网络和磁盘
- 最坏结果：机器变砖开不了机。数据还在盘上，但需要从别的机器做启动盘重装才能救回来
- 能力边界：只支持全新安装和升级。其他补丁器（bigmac、Patched Sur 之类）改过的环境接管不了
- 备份：动 EFI 分区和根卷之前，Time Machine 或全盘克隆，这一步没有商量
确认机型标识还在支持列表
开任何口子之前，先确认这台机器名正言顺地出现在官方支持表里。
sysctl -n hw.model把输出的标识（形如iMac14,2、MacBookPro11,5）拿去对照 docs/MODELS.md 的表格，重点看 Additional info 一列标了哪些图形、USB 已知问题，判断能不能接受。表头还有一条警告：先把机器升到它原生支持的最新系统版本，固件才在新，后面打补丁才稳。
机型不在列表就停手，不要继续往下写 EFI 分区。
⚠️ 2GB 内存机型在 Sonoma/Sequoia 上装不完，甚至可能起不来，MODELS.md 里写明了，别抱着侥幸试。
克隆源码并装齐依赖
这一步把源码和运行环境一次性备齐，后面所有命令都在这个目录里跑。
git clone https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher cd OpenCore-Legacy-Patcher pip3 install -r requirements.txtpip 会逐个安装 wxpython、pyobjc、pyinstaller 等 10 个包，全部装完无报错退出就是成了。
⚠️ 装依赖报权限或编译错误，先检查 Python 是不是 python.org 官方版，排障路径见 docs/SOURCE.md，别去装乱七八糟的替代源。
启动 GUI，验证硬件检测读对了
源码就绪后先别急着构建，打开工具确认它真的认得这台机器——检测读错，后面生成的整套配置就全歪了。
python3 OpenCore-Patcher-GUI.command窗口标题栏会显示版本号，主区域直接列出检测到的机型标识（如 MacBookPro11,5），下方是四个主入口：Build and Install OpenCore、Post-Install Root Patch、Create macOS Installer、Support。对照sysctl -n hw.model的输出，标识一致才继续。
💡 不想开图形界面，同一个入口能当 CLI 用：python3 OpenCore-Patcher-GUI.command --build --model iMac12,2 --verbose直接无头构建，-h看全部参数。
把 OpenCore 引导器写进 EFI 分区
构建命令会解析机型、生成绑定这台机器的配置，然后把引导器写进目标磁盘的 EFI 或 FAT32 分区。
python3 OpenCore-Patcher-GUI.command --build按提示从列表里挑目标磁盘（只认 FAT32 或 GPT 格式的盘），确认写入。写入完成后，所选分区里出现引导文件，构建产物落在仓库内的 Build-Folder 目录。
⚠️ 生成的配置绑定当前机型：构建时机型没选对、或这台机器实际是另一个标识，写出来的引导配置直接无法启动，必须重选机型整步重跑。
新系统起来后，给根卷打补丁
引导器只解决"装得上"，新系统装完不补根卷，图形加速是缺的。这一步替换根卷里缺失的框架和内核组件，重建内核缓存。
python3 OpenCore-Patcher-GUI.command --patch_sys_vol补丁列表逐项应用完、内核缓存重建成功，界面给出完成状态。重启后图形加速、音频恢复正常。
⚠️ 两条规律要记住：大版本 OTA 更新会重建根卷，补丁随之失效，重跑同一条命令即可；反过来，根卷处于脏状态时（2.5.0 起的行为）工具会拒绝打补丁，先修复脏根卷再补。
验证与排错
全部走完后，用下面四条命令逐项核对：
| 检查项 | 命令 | 正常标准 |
|---|---|---|
| 引导器版本 | nvram -p \| grep -i opencore | 打印出 OpenCore 版本号 |
| 基础内核扩展 | kextstat \| grep -i lilu | Lilu、WhateverGreen 在列 |
| 无线驱动 | kextstat \| grep -i airport | AirPortBrcmFixup 在列 |
| 图形加速 | system_profiler SPDisplaysDataType | 显示加速可用 |
三条不正常的场景，按现象定位：
- 重启后没进新系统→ 引导器根本没跑起来，
nvram -p读不到版本。回到"把 OpenCore 引导器写进 EFI 分区"那一步重选分区写入，加--verbose拿详细日志 - Wi-Fi 图标灰着→ 无线芯片没被识别，AirPortBrcmFixup 不在列。回构建流程让它重新检测无线芯片后重建
- 大版本更新后掉回无加速→ 根卷被 OTA 重建，补丁失效。重跑
--patch_sys_vol
更多场景按硬件、应用、非 Metal 图形分类，见 docs/TROUBLESHOOTING.md。
三层伪装：为什么安装器以为你是新机器
它不改固件、不动硬件，能成靠的是三个层面各干一件事。EFI 阶段，OpenCore 往内存里注入一个受支持机型的 SMBIOS 标识，安装器看到的只是"新机器"。内核阶段，Lilu 拦截被 Apple 移除的符号并做内存重定向，只改内存不落盘。系统起来后，payloads/目录里随仓库打包的 WhateverGreen、AppleALC、AirPortBrcmFixup、NVMeFix 等驱动逐一加载接管硬件，根补丁再重建内核缓存、替换根卷里需要修补的框架，非 Metal 图形走回退路径兜底。
收尾
OCLP 只做全新安装与升级两条路：接管不了其他补丁器留下的环境，Apple Silicon 一律不支持。先把机型标识在 docs/MODELS.md 里确认到，然后从克隆源码那一步走起。
【免费下载链接】OpenCore-Legacy-PatcherExperience macOS just like before项目地址: https://gitcode.com/GitHub_Trending/op/OpenCore-Legacy-Patcher
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考