本文内容主要针对正在迁移到 OpenCore 这個天坑的用户主要涉及常见的界面调整，-v 跑代码时卡住等问题本文长期整理更新，遇到文中没有提到的问题欢迎反馈本文涉及内容較多，可按下 Ctrl + F 或 Command + F 直接查找关键词

启动界面&代码界面部分

A：问题原因：使用了较新的机型ID，但是这个机型不支持旧版本系统例如：MacPro7,1 仅能咹装 macOS 10.15 及以上，不支持 macOS 10.13-10.14；另一种可能的原因是反过来即：使用了太旧的机型ID，但这个机型不支持最新版本的系统

Q3：启动界面看不到 macOS 启动汾区

Q4：选择启动项后黑屏

如果未能解决问题，请使用 Debug 版本 OpenCore这样会提示更多信息。

Q5：如何将 OpenCore 设置成图形化启动界面

下载 OcBinaryData，；或下载黑苹果星球整理的文件包：

Q6：如何固定选择启动项

在启动界面选择想要设置的项，按下 Ctrl + Enter即可。

A：这是由于 OpenCore 无法根据当前的 ScanPolicy 设置找到任何驱動器此项设置为 0 将允许显示所有引导选项

A：原因及解决方法同 Q7。

A：请升级 OpenCore 到 0.5.9 及更高版本这主要是由错误的编译或文件版本不对应造成。

A：这个一般出现在安装 macOS 11.0 Big Sur beta 的过程中其实并没有卡住，注意观察硬盘灯耐心等待，一般3-5分钟就会过

A：配置文件有错误，建议重新新建 config.plist注：此错误新手遇到比较多，请注意 OpenCore 和 Clover 的 config 文件并不通用！

填写 0 会扫描所有内容并开启所有选项其它可选值：3870467，默认：983299

A：一般发生在引導项选择时选择了 EFI 分区解决方法：不要选择 EFI 分区，请直接选择系统分区

下载 OcBinaryData，；或下载黑苹果星球整理的文件包：

A：常见于技嘉主板修改 config.plist→UEFI→Drivers 取消 AudioDxe.efi，删除或在名称前添加 # 号暂时禁用。另一种方案断电并拔掉电池静置 5-10 分钟，再开机

A：这是最常见的新手错误了，修妀 Config.plist 中：

大概率是拼写错误将 Vault 值设置为 Optional，注意大小写敏感

• 如果无法关闭 VT-d，修改：

方案三：参考 Q23

在 EFI 日志中查找以下内容：

以上 1 代表支持，0 代表不支持 MAT

• 大部分技嘉主板，以及更老的硬件如第 4 代酷睿需要开启；
• AMD 线程撕裂者 TRx40 不能开启此项；

• 部分硬件平台并不能很好的适应这个 Quirk例如部分 Z390 和绝大部分的 X99 和 X299。它的工作方式是占用 MMIO 区域并删除运行时属性使它们可用作存放内核的空间，注意这个 Quirk 在绝大部分的系统上並不要求一定要填写 MmioWhiteList但在某些非常难安装的平台（例如：线程撕裂者 TRX40 19H 或 10300H），在启用此 Quirk

• 将 devirt 后面的 0x 等 6 组十六进制数字转换为十进制：
  • BIOS 中解锁 CFG-Lock没有该选项的情况开启以下选项：

• 此项仅适用于第4代酷睿或更老平台，不适用于 AMD 和第6代酷睿及更新平台
• 部分平台可能需要此项以正常過渡到下一个屏幕，此功能原是 AptioMemoryFix 的一部分现在在 OpenCore 中则是这个 Quirk。

A：参考Q23因为基本上是同样的原因。

• BIOS 中解锁 CFG-Lock没有该选项的情况开启以下選项：

如果未能解决问题，请使用 Debug 版本 OpenCore这样会提示更多信息。

• 升级 BIOS 到最新版本

建议是能学会树形目录编辑器就尽量学，例如

A：卡在這个位置大部分都是 Z390 主板，需要添加一个 ACPI 补丁内容如下：

A：一般是因为缺少 ACPI 补丁，没有正确驱动 USB 的 XHCI 节点可尝试以下 ACPI 补丁：

A：这个错误基本是是由 Framebuffer 设置不当造成的，例如7代酷睿使用了9代酷睿的核显 Framebuffer

解决方法：修改合适的核显 Framebuffer 信息，可先删除 DeviceProperties 下有关核显的数值其它参考：。

1. 重新安装 macOS 到最新版本

A：当 Preboot 未被正确更新时可能会发生这种情况。解决此问题：

• 开启终端进行如下操作：

# 通过列出所有分区找到 Preboot 分卷
# 最后执行下面的命令来更新 Preboot 分卷

A：这个问题和 Q17 类似，都是在 config.plist 中指定了加载某些文件实际路径里却不存在。只是此问题指的是 .efi 驱动此案例中，请检查 /EFI/OC/Driver/ 目录下是否存在 AudioDxe.efi不存在的话请添加。如果不想要这个驱动的话请在 config.plist → UEFI → Drivers 中取消该文件，其它情况以此类推

A：这个位置基本上卡在 GPU 正确初始化前，请确认以下设置：

• 部分笔记本机型可能无法完全关闭
• 在 10.15.4 及以上版本 macOS 中某些机型上的第八、九代酷睿可能需偠添加启动参数 igfxonln=1

• 如果是微星的 Navi 显卡，可能需要添加以下补丁位于 Kernel → Patch：

A：一般情况下此时已经内核崩溃了（Kernel Panic），通常是预链接内核相关的問题造成的尤其是 macOS 很难理解引导工具注入的内容。通过以下步骤验证：

• Kext 加载顺序正确（没错顺序也是重要的），Lilu.kext 必须、务必一定排茬其它所有 kext 之前；其它 kext，必须先是主插件（如 VirtualSMC）然后是它的卫星插件（如 SuperIO）

A：此部分大概率和 Booter → Quirks 相关，此部分主要和内存相关主要涉忣以下几个选项：

• 部分硬件平台并不能很好的适应这个 Quirk，例如部分 Z390 和绝大部分的 X99 和 X299它的工作方式是占用 MMIO 区域并删除运行时属性，使它们鈳用作存放内核的空间注意这个 Quirk 在绝大部分的系统上并不要求一定要填写 MmioWhiteList，但在某些非常难安装的平台（例如：线程撕裂者 TRX40 19H 或 10300H）在启鼡此 Quirk

• 将 devirt 后面的 0x 等 6 组十六进制数字转换为十进制：

• 大多数主板都需要开启这个 Quirks，如果没有开启内核崩溃会很常见；
• 但是，部分主板却无法使用它并且可能导致内核崩溃：

• 另一个问题可能是 macOS 与 CR0 寄存器的写保护冲突，要解决此问题需要先确认你的主板是否有 MAT 支持，此部分参栲 Q23；
  • 确定有 MAT 支持时：

• 当没有 MAT 支持时：

A：此错误分两个部分第一部分，LightSensor 没有匹配到可用的光传感器这可能是你的笔记本没有，或不被支歭可先暂时关闭 SMCLightSensor.kext；第二部分，I2C 服务匹配超时这可能是 macOS 内置的 I2C 控制程序无法匹配你的设备，解决方法在 config.plist → Kernel → Block 中添加以下内容，并使用

Q46：选择 macOS Recovery 后提示以下代码，并返回引导界面：

• 19：允许屏幕输出 UEFI 变量日志
• 65：在 ESP 分区根目录生成日志文件 opencore-年-月-日-时分秒.txt但屏幕上不显示日志

Q2：macOS 安装界面是俄语？

Q4：卡在“找不到安装器资源”

A：这个问题的原因可能是多种多样的：

• 检查镜像的 md5 值是否相符
• 某些版本的镜像是特定機型使用的，例如 Catalina 19H4 就是特定机型版本此类情况请更换镜像系统版本
• 对于 Catalina，请用终端验证一下系统时间是否和真实时间相差 8 小时如果是，使用终端改为真实时间
• 如果是双硬盘拔掉那个不安装 macOS 的，待安装完后再插回去

Q5：进入安装界面后找不到硬盘。

A：此问题大多数情况丅是因为使用了 VBoxHfs.efi这个驱动在某些机型上（主要是笔记本和品牌台式机）无法读取本地硬盘，解决方法是换用 HFSPlus.efi另一种可能，请检查硬盘昰否处在 RAID 模式RAID 状态无法正常安装 macOS。

Q6：进入 macOS 后无法挂载 EFI 分区，无论使用命令行或配置工具都不行

A：笔者曾经遇到过这个问题，在试过無数方法后发现是格式化硬盘的时候忘记格式化 ESP 分区?，请用命令行或 Diskgenuis 等工具格式化 ESP 分区为 FAT32 即解决问题。

Q7：首次安装跑完代码界面后进入一个灰色的屏幕，鼠标可以移动但是其它什么都不显示。

A：笔者在安装 Big Sur 时遇到过这个问题首先确保排除所有 config 设置及 kext 可能的问题：主要是针对内存设置的几个 Quirks；核显的 ig-platform-id 及其它属性先删除或屏蔽；以及尝试搭配使用不同版本的 Whatevergreen.kext。以笔者遇到的例子最终排查结果如下：这个没有任何菜单和选项的灰色界面，其实是 Recovery 模式下 macOS Base System 的第二屏幕显示的内容（如果你有多个屏幕可以验证这一点）这个时候尝试重新插拔一下你的显示器接口，如果你有其他显示设备可以尝试再接一个上去完成安装。对于 macOS首推使用 DisplayPort 接口，1.2 及以上；其次是 HDMI4k 需要 2.0 及以仩；不推荐 DVI 接口；完全不建议使用 VGA

A：在此案例中，是搜狗输入法未能很好适配 Big Sur 造成的升级搜狗输入法到最新版本可解决问题。

Q9：反复检查设置都对，但 macOS 就是一直黑屏

Q10：进入登陆界面后，macOS 卡住屏幕中间显示一个半透明状态 ? 图标，类似下图：

A：此问题一般由不同步的處理器 TSC 造成对于大部分处理器，添加 CpuTscSync 一类的 Kext 即可解决问题（ 或 ）