尧图网页设计 
文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载当 OpenCore 成功进入安装器、图形界面已经加载之后真正的排错才刚刚开始。本文围绕 OpenCore-Install-Guide 仓库中的 userspace-issues.md 展开系统梳理从安装器语言变成俄语到卡在 2 分钟剩余、再到Your Mac needs a firmware update等十余类安装器阶段高频问题覆盖prev-lang:kbd、NVRAM - Add/Delete、Kernel - Patch、Kernel - Emulate、PlatformInfo等 OpenCore 核心配置项的实战调整并提供可直接复制使用的命令与补丁。读完本文你将能独立判断问题出在 GPU 初始化、NVRAM、SMBIOS 还是存储介质并给出对应解法。文档定位进入图形界面之后的排错地图仓库中 troubleshooting/boot.md 将启动排错分为内核阶段与用户空间阶段userspace-issues.md 专门负责once youve booted the installer and the GUI has loaded——即内核已经引导、安装器 GUI 已经呈现之后出现的各类问题。与之配套的 kernel-issues.md 覆盖更早的内核阶段两者以IOConsoleUsers: gIOScreenLock...为界该日志出现在 GPU 即将完成初始化之前属于典型的内核尾声/用户空间前夜临界点本文后续会详细展开。安装器界面语言异常prev-lang:kbd与 NVRAM 的恩怨现象与根因默认示例配置sample config中的prev-lang:kbd被设为俄语因此部分用户首次启动安装器时会看到俄文界面。语言由 OpenCore 注入到 NVRAM 的7C436110-AB2A-4BBB-A880-FE41995C9F82即boot-argsGUID变量控制。修复方法修改 NVRAM 注入值打开config.plist定位到NVRAM - Add - 7C436110-AB2A-4BBB-A880-FE41995C9F82将prev-lang:kbd的值改为美式英语对应的 HEX 编码656e2d55533a30即文本en-US:0完整键盘布局列表见 AppleKeyboardLayouts.txt外部仓库文件此处仅作背景说明修改后需要在引导选择器boot picker中执行一次重置 NVRAMReset NVRAM否则旧的 NVRAM 变量可能仍然生效。⚠️ThinkPad 注意ThinkPad 笔记本在 OpenCore 中重置 NVRAM 后存在半变砖的已知风险这类机型建议通过更新 BIOS 的方式间接清空 NVRAM而不是在引导选择器里直接 Reset NVRAM。纯文本编辑器场景的编码陷阱如果使用 UEFI Shell、Notepad 等纯文本工具编辑 plist656e2d55533a30会被工具自动按 ASCII 转码为ZW4tVVM6MABase64导致注入失败。两种规避方式使用 ProperTree 等 plist 原生编辑器以 Data 类型保存 HEX将prev-lang:kbd的类型改为String直接填写en-US:0OpenCore 会自行处理AMD/fx.md 中同样给出了这个 Hint。仍无效强制删除并让 OpenCore 重建如果修改值后依然无效可以直接删除该 NVRAM 变量让 OpenCore 在下次启动时按新值重建NVRAM - Delete - 7C436110-AB2A-4BBB-A880-FE41995C9F82 - Item 0并设置其Type为String、Value为prev-lang:kbd。安装器提示已损坏damaged过期的安装证书2019 年 10 月之前下载的 macOS 安装镜像其安装器证书已经过期安装器会拒绝运行。仓库文档给出两条路线重新下载最新版 macOS推荐一劳永逸在恢复终端中把系统日期改回证书有效期内跳过校验后完成安装date 0901000019注意操作顺序先断开所有网络设备拔掉网线、关闭 Wi-Fi再在恢复终端执行上述命令将日期设为 2019 年 9 月 1 日随后正常安装。安装完成后应尽快恢复系统时间。卡在IOConsoleUsers: gIOScreenLock.../gIOLockState (3...GPU 初始化临界点该日志出现于 GPU 即将完成初始化的瞬间随后屏幕应点亮。若在此卡死按以下清单逐项核对GPU 必须支持 UEFIGTX 7XX2013 年及更新的显卡通常可以BIOS 中关闭 CSMCompatibility Support Module强制 PCIe 3.0 链路速率部分主板 BIOS 提供此选项核显iGPU用户再次核对ig-platform-id与device-id是否有效例如台式机 UHD 630 可能需要改用00009B3E尝试 VariousGreen 系列修复参数详见 WhateverGreen Fixes-igfxmlr绕过部分帧缓冲限制若缺失该参数有时会表现为 Divide by Zero 错误Coffee Lake 核显在 10.15.4 及更新版本上可能还需要igfxonln1。这些 boot-args 与 config.plist 各平台示例 中核显章节使用的-igfxmpc、-igfxcdc等参数同属 WhateverGreen 注入体系使用时按你的 iGPU 代次与 macOS 版本取舍。笔记本 / 一体机黑屏背光与核显属性两座大山花屏Scrambled Screen先开 CSM笔记本出现花屏时进入 UEFI 设置开启 CSM可能显示为 Boot legacy ROMs 或其他 legacy 选项。黑屏核显属性与 PNLF在IOConsoleUsers: gIOScreenLock...之后黑屏常见于笔记本与 AIO逐项排查SSDT-PNLF 是否安装确认EFI/OC/ACPI中存在该 SSDT且已在config.plist - ACPI - Add中注册。它的作用是启用背光控制config-laptop.plist 示例 中将其列为亮度修复的必需 SSDTiGPU 属性确认DeviceProperties - Add - PciRoot(0x0)/Pci(0x2,0x0)下的属性如AAPL,ig-platform-id、framebuffer-patch-enable等配置正确Coffee Lake 及更新平台向 boot-args 追加-igfxblr或等价地在PciRoot(0x0)/Pci(0x2,0x0)下添加enable-backlight-registers-fix | Data | 01000000最后别忘了回到上一节核对IOConsoleUsers卡死的全部前置条件——二者经常连锁出现。Navi 显卡黑屏agdpmod与 MSI 专属补丁agdpmodpikera是首选RX 5000/6000Navi系列在部分配置下需要跳过板卡 ID 检查否则黑屏在 boot-args 中添加agdpmodpikera若仍黑屏尝试切换不同显示输出接口或改用 MacPro7,1 SMBIOS 并携带 boot-argagdpmodignore。从源码结构看agdpmodpikera的语义是忽略板卡 ID 校验agdpmodignore则完全绕开 AGDP 检查仓库各平台示例如 AMD/fx.md、config.plist/coffee-lake.md均强调没有 Navi 显卡如 Polaris、Vega不要使用该参数。MSI Navi 用户的 VBIOS 补丁MSI Navi 显卡在安装器阶段会因 VBIOS 签名问题失败需要在Kernel - Patch添加如下条目源自 acidanthera bugtracker #901 的修复此处给出补丁原文Base: Comment: Navi VBIOS Bug Patch Count: 1 Enabled: YES Find: 4154592C526F6D2300 Identifier: com.apple.kext.AMDRadeonX6000Framebuffer Limit: 0 Mask: MinKernel: MaxKernel: Replace: 414D442C526F6D2300 ReplaceMask: Skip: 0该补丁本质是把AMDRadeonX6000Framebuffer中 ROM 字符串的ATY,Rom#替换为AMD,Rom#绕过 MSI 固件里不兼容的 VBIOS 表头。Find/Replace均为 Data 类型Count: 1表示只匹配一次Enabled: YES确保补丁生效。安装器 30 秒后冻结NullCPUPowerManagement 的坑安装器启动约 30 秒后冻结通常是NullCPUPowerManagement.kextNullCPUPowerManagement缺失或损坏所致——AMD OSX Vanilla Guide 托管的版本已知损坏。修复步骤从Kernel - Add中移除 NullCPUPowerManagement同时删除EFI/OC/Kexts下对应的 kext 文件在Kernel - Emulate下启用DummyPowerManagement。关于DummyPowerManagementAMD/fx.md 明确说明它是 NullCPUPowerManagement 的新替代方案AMD CPU 系统由于没有原生电源管理必须开启Intel 平台的 HEDT 示例如 broadwell-e.md则保持No。clover-conversion/clover-efi.md 也印证了这一点Clover 时代的 NullCPUPowerManagement 在 OpenCore 中已被整合为Kernel - Emulate - DummyPowerManagement。15h/16h 老 AMD CPUData Privacy 界面后重启AMD 15h/16hBulldozer/Piledriver 及衍生CPU 在 Data Privacy 界面后反复重启需要参考 insanelymac 上 AMD Mojave 内核开发帖 UPDATE 2 之后的方案处理该帖对 AMD 内核打补丁的演进过程有完整记录。这属于 AMD 内核补丁历史问题若你的平台较新Zen 及以后通常不会遇到。登录前冻结TSC 失同步常规系统CpuTscSyncmacOS 登录界面之前冻结是 TSC时间戳计数器不同步的典型表现多数系统安装 CpuTscSync 将其收录为关键词。Skylake-X 特殊场景TSCAdjustResetSkylake-X如 i9 7980XE的不少固件含 Asus、EVGA不会把 TSC 同步写入所有核心需要在冷启动和唤醒时用 TSCAdjustReset使用方法解压 kext在 Finder 中显示包内容Show Package Contents进入Contents - Info.plist修改IOKitPersonalities - IOPropertyMatch - IOCPUNumber为你的CPU 线程数减 1从 0 开始计数。例如 18 核 36 线程的 i9 7980XE 应填35。最直观的确认方式看安装器是否卡在两个经典界面如 asus-tsc.png 与 asus-tsc-2.png 所示的 TSC 相关冻结画面特征是进度条/界面无响应且无错误日志。MediaKit 空间不足与磁盘工具无法抹盘MediaKit reports not enough space该报错源于EFI 分区过小Windows 默认创建 100MB EFI而 macOS 期望 200MB。两条出路扩容 EFI 分区到 200MB操作方式请自行检索格式化整块磁盘而非仅格式化分区。注意磁盘工具Disk Utility默认只显示分区按Cmd/Win 2或点击视图按钮切换为显示所有设备Show All Devices才能看到整块磁盘并对其执行格式化。对应界面可参考 Default.png默认视图与 Showalldevices.pngCmd2 视图。DiskUtility 无法抹盘failing to erase按可能性从高到低排查格式化的是分区而非整盘——见上文 MediaKit 问题磁盘工具首次抹盘失败的重试 bug再点一次抹盘即可BIOS 中 SATA Hot-plug热插拔导致问题尝试关闭该选项固件过旧将硬盘固件更新到最新硬盘本身损坏换盘验证。SATA 硬盘不出现在磁盘工具中确认 BIOS 中SATA Mode 为 AHCI各平台示例均将 AHCI 列为安装前置条件如 AMD/zen.md若 macOS 不支持你的 SATA 控制器使用 CtlnaAHCIPort.kext.zip 强制启用非官方 SATA 控制器非常老旧的 SATA 控制器可尝试 AHCIPortInjector.kext。卡在2 分钟剩余2 minutes remaining该阶段 macOS 正在向 NVRAM 写入开机所需的关键变量任何 NVRAM 问题都会让安装在此停滞典型画面见 2-min-remaining.jpeg。按平台选择解法Intel 300 系列如 Z390安装 SSDT-PMC仓库 Misc-files 之外另提供编译产物用于解锁被固件隐藏的 PMC NVRAM 区域其他平台在config.plist中设置以下 NVRAM 相关选项LegacyEnable - YES LegacyOverwrite - YES WriteFlash - YES其中WriteFlash允许 OpenCore 向固件 NVRAM 写入AMD/zen.md 将其列为 NVRAM 写入开关LegacyEnable/LegacyOverwrite则负责老式 NVRAM 变量区的读写与覆盖。无法联系恢复服务器The recovery server cannot be contactedWindows/Linux 下制作的安装 U 盘通常是基于恢复模式recovery-based只有一小部分安装器本体在磁盘上其余内容在安装过程中从 Apple 服务器下载。仓库不推荐全量安装器镜像的原因是 HFS 驱动不稳定、相关工具易造成数据损坏。排查顺序确认网络连通在安装器的Utilities菜单中打开Network Utility检查网卡是否被识别网卡不出现→ 缺少对应网卡 kext请参考 Ethernet Kexts 与 Finding your hardware 选择正确的驱动网卡已出现→ 在安装器终端执行连通性测试ping -c3 www.google.com无响应网络或 kext 异常可尝试换用旧版 kext新版可能存在兼容性 bug有响应问题在 Apple 服务器端只能改日再试。界面参考check-network.png检查网卡与 ping.pngPing 测试。Big Sur 下键鼠失效IOHIDFamily 内核补丁Core 2 Duo / 2010 年及更早的老平台在 Big Sur 下 USB 口有电但 HID 键鼠不工作需要对com.apple.iokit.IOHIDFamily打补丁原始出处为 applelife.ru 讨论帖。在config.plist - Kernel - Patch添加KeyTypeValueBaseString_isSingleUserCountInteger1EnabledBooleanTrueFindData空IdentifierStringcom.apple.iokit.IOHIDFamilyLimitInteger0MaskData空MaxKernelString空MinKernelString20.0.0ReplaceDataB801000000C3ReplaceMaskData空SkipInteger0该补丁用MinKernel: 20.0.0限定仅在 Big Sur 及更新系统上生效Replace: B801000000C3是将_isSingleUser相关检查替换为直接返回成功的机器码从而恢复 HID 设备枚举。Your Mac needs a firmware updateSMBIOS 表过时该提示通常意味着SMBIOS 表信息过旧无法满足 APFS 卷安装要求。依次核对PlatformInfo - Automatic已启用UpdateSMBIOSMode设为Create用新分配的EfiReservedMemoryType替换 SMBIOS 表同时确保CustomSMBIOSGuid为关闭Dell 与 VAIO 例外需要CustomSMBIOSGuid开启且UpdateSMBIOSMode设为Custom——两者必须成对出现AMD/zen.md 说明该组合会禁用向非 Apple 系统注入 SMBIOS可能破坏 Bootcamp 兼容性谨慎使用使用当前 macOS 版本支持的 SMBIOS不要依赖-no_compat_check硬闯使用最新版 OpenCore。若仍报错说明 OpenCore 自身残留了过时的 SMBIOS 信息建议换用相近的 SMBIOS 验证完整的机型选择指南见 Choosing the right SMBIOS其中详细解释了 CPU 类型、GPU 类型iGPU 是否存在、XCPM 支持列表等选型因素——这直接决定你换用哪个 SMBIOS 才不会引入新的电源管理或显示问题。排错路线总结症状首要怀疑对象首选动作安装器语言非英文NVRAMprev-lang:kbd改656e2d55533a30并重置 NVRAM安装器已损坏证书过期改系统日期为0901000019卡IOConsoleUsersGPU 初始化关 CSM / 校验 ig-platform-id /-igfxmlr笔记本黑屏背光/核显装 SSDT-PNLF /-igfxblrNavi 黑屏AGDP 板卡检查agdpmodpikera/ MSI VBIOS 补丁30 秒冻结NullCPUPowerManagement换DummyPowerManagement登录前冻结TSC 失同步CpuTscSync / TSCAdjustResetSkylake-X2 分钟剩余NVRAM 写入SSDT-PMC300 系/ WriteFlash 等无法联系恢复服务器网络/kextNetwork Utility 定位 ping -c3Big Sur 键鼠失效IOHIDFamilyKernel - Patch打补丁需固件更新提示SMBIOS 过旧UpdateSMBIOSMode - Create或换 SMBIOS以上所有修复均围绕 OpenCore 的四个核心配置区块——NVRAM、DeviceProperties、Kernel、PlatformInfo展开对应的完整示例配置可对照 config.plist 各平台文档 与 config-laptop.plist 下的具体平台文件按需取用。排错时建议每次只改一个变量并在引导选择器中重置 NVRAM 后再验证这样能最大程度避免多个修复相互掩盖根因。赞分享文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载相关推荐AI前端设计范式革命从平庸模板到设计系统的智能跃迁AI前端设计范式革命从平庸模板到设计系统的智能跃迁 在当今AI辅助开发的时代前端开发者面临着一个看似矛盾的困境大语言模型虽然能够快速生成代码但其输出的UAI 技能前端设计系统从数据备份到AI训练WeChatMsg的三重价值探索从数据备份到AI训练WeChatMsg的三重价值探索 在数字生活日益丰富的今天微信聊天记录已不仅仅是简单的文字交流它承载着我们的情感记忆、工作沟通和生活轨OpenStack Nova调度器工作原理揭秘从请求到资源分配的完整流程OpenStack Nova调度器工作原理揭秘从请求到资源分配的完整流程 OpenStack Nova调度器是OpenStack云计算平台的核心组件之一负责后端云原生虚拟化上一篇Kodi IPTV Simple 配置难题全解析5步搞定直播卡顿问题下一篇Android-Smart-Login进阶自定义登录系统的实现与优化指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 OpenCore 安装指南：macOS 安装器引导成功后的用户空间疑难杂症排查手册
文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载当 OpenCore 成功进入安装器、图形界面已经加载之后真正的排错才刚刚开始。本文围绕 OpenCore-Install-Guide 仓库中的 userspace-issues.md 展开系统梳理从安装器语言变成俄语到卡在 2 分钟剩余、再到Your Mac needs a firmware update等十余类安装器阶段高频问题覆盖prev-lang:kbd、NVRAM - Add/Delete、Kernel - Patch、Kernel - Emulate、PlatformInfo等 OpenCore 核心配置项的实战调整并提供可直接复制使用的命令与补丁。读完本文你将能独立判断问题出在 GPU 初始化、NVRAM、SMBIOS 还是存储介质并给出对应解法。文档定位进入图形界面之后的排错地图仓库中 troubleshooting/boot.md 将启动排错分为内核阶段与用户空间阶段userspace-issues.md 专门负责once youve booted the installer and the GUI has loaded——即内核已经引导、安装器 GUI 已经呈现之后出现的各类问题。与之配套的 kernel-issues.md 覆盖更早的内核阶段两者以IOConsoleUsers: gIOScreenLock...为界该日志出现在 GPU 即将完成初始化之前属于典型的内核尾声/用户空间前夜临界点本文后续会详细展开。安装器界面语言异常prev-lang:kbd与 NVRAM 的恩怨现象与根因默认示例配置sample config中的prev-lang:kbd被设为俄语因此部分用户首次启动安装器时会看到俄文界面。语言由 OpenCore 注入到 NVRAM 的7C436110-AB2A-4BBB-A880-FE41995C9F82即boot-argsGUID变量控制。修复方法修改 NVRAM 注入值打开config.plist定位到NVRAM - Add - 7C436110-AB2A-4BBB-A880-FE41995C9F82将prev-lang:kbd的值改为美式英语对应的 HEX 编码656e2d55533a30即文本en-US:0完整键盘布局列表见 AppleKeyboardLayouts.txt外部仓库文件此处仅作背景说明修改后需要在引导选择器boot picker中执行一次重置 NVRAMReset NVRAM否则旧的 NVRAM 变量可能仍然生效。⚠️ThinkPad 注意ThinkPad 笔记本在 OpenCore 中重置 NVRAM 后存在半变砖的已知风险这类机型建议通过更新 BIOS 的方式间接清空 NVRAM而不是在引导选择器里直接 Reset NVRAM。纯文本编辑器场景的编码陷阱如果使用 UEFI Shell、Notepad 等纯文本工具编辑 plist656e2d55533a30会被工具自动按 ASCII 转码为ZW4tVVM6MABase64导致注入失败。两种规避方式使用 ProperTree 等 plist 原生编辑器以 Data 类型保存 HEX将prev-lang:kbd的类型改为String直接填写en-US:0OpenCore 会自行处理AMD/fx.md 中同样给出了这个 Hint。仍无效强制删除并让 OpenCore 重建如果修改值后依然无效可以直接删除该 NVRAM 变量让 OpenCore 在下次启动时按新值重建NVRAM - Delete - 7C436110-AB2A-4BBB-A880-FE41995C9F82 - Item 0并设置其Type为String、Value为prev-lang:kbd。安装器提示已损坏damaged过期的安装证书2019 年 10 月之前下载的 macOS 安装镜像其安装器证书已经过期安装器会拒绝运行。仓库文档给出两条路线重新下载最新版 macOS推荐一劳永逸在恢复终端中把系统日期改回证书有效期内跳过校验后完成安装date 0901000019注意操作顺序先断开所有网络设备拔掉网线、关闭 Wi-Fi再在恢复终端执行上述命令将日期设为 2019 年 9 月 1 日随后正常安装。安装完成后应尽快恢复系统时间。卡在IOConsoleUsers: gIOScreenLock.../gIOLockState (3...GPU 初始化临界点该日志出现于 GPU 即将完成初始化的瞬间随后屏幕应点亮。若在此卡死按以下清单逐项核对GPU 必须支持 UEFIGTX 7XX2013 年及更新的显卡通常可以BIOS 中关闭 CSMCompatibility Support Module强制 PCIe 3.0 链路速率部分主板 BIOS 提供此选项核显iGPU用户再次核对ig-platform-id与device-id是否有效例如台式机 UHD 630 可能需要改用00009B3E尝试 VariousGreen 系列修复参数详见 WhateverGreen Fixes-igfxmlr绕过部分帧缓冲限制若缺失该参数有时会表现为 Divide by Zero 错误Coffee Lake 核显在 10.15.4 及更新版本上可能还需要igfxonln1。这些 boot-args 与 config.plist 各平台示例 中核显章节使用的-igfxmpc、-igfxcdc等参数同属 WhateverGreen 注入体系使用时按你的 iGPU 代次与 macOS 版本取舍。笔记本 / 一体机黑屏背光与核显属性两座大山花屏Scrambled Screen先开 CSM笔记本出现花屏时进入 UEFI 设置开启 CSM可能显示为 Boot legacy ROMs 或其他 legacy 选项。黑屏核显属性与 PNLF在IOConsoleUsers: gIOScreenLock...之后黑屏常见于笔记本与 AIO逐项排查SSDT-PNLF 是否安装确认EFI/OC/ACPI中存在该 SSDT且已在config.plist - ACPI - Add中注册。它的作用是启用背光控制config-laptop.plist 示例 中将其列为亮度修复的必需 SSDTiGPU 属性确认DeviceProperties - Add - PciRoot(0x0)/Pci(0x2,0x0)下的属性如AAPL,ig-platform-id、framebuffer-patch-enable等配置正确Coffee Lake 及更新平台向 boot-args 追加-igfxblr或等价地在PciRoot(0x0)/Pci(0x2,0x0)下添加enable-backlight-registers-fix | Data | 01000000最后别忘了回到上一节核对IOConsoleUsers卡死的全部前置条件——二者经常连锁出现。Navi 显卡黑屏agdpmod与 MSI 专属补丁agdpmodpikera是首选RX 5000/6000Navi系列在部分配置下需要跳过板卡 ID 检查否则黑屏在 boot-args 中添加agdpmodpikera若仍黑屏尝试切换不同显示输出接口或改用 MacPro7,1 SMBIOS 并携带 boot-argagdpmodignore。从源码结构看agdpmodpikera的语义是忽略板卡 ID 校验agdpmodignore则完全绕开 AGDP 检查仓库各平台示例如 AMD/fx.md、config.plist/coffee-lake.md均强调没有 Navi 显卡如 Polaris、Vega不要使用该参数。MSI Navi 用户的 VBIOS 补丁MSI Navi 显卡在安装器阶段会因 VBIOS 签名问题失败需要在Kernel - Patch添加如下条目源自 acidanthera bugtracker #901 的修复此处给出补丁原文Base: Comment: Navi VBIOS Bug Patch Count: 1 Enabled: YES Find: 4154592C526F6D2300 Identifier: com.apple.kext.AMDRadeonX6000Framebuffer Limit: 0 Mask: MinKernel: MaxKernel: Replace: 414D442C526F6D2300 ReplaceMask: Skip: 0该补丁本质是把AMDRadeonX6000Framebuffer中 ROM 字符串的ATY,Rom#替换为AMD,Rom#绕过 MSI 固件里不兼容的 VBIOS 表头。Find/Replace均为 Data 类型Count: 1表示只匹配一次Enabled: YES确保补丁生效。安装器 30 秒后冻结NullCPUPowerManagement 的坑安装器启动约 30 秒后冻结通常是NullCPUPowerManagement.kextNullCPUPowerManagement缺失或损坏所致——AMD OSX Vanilla Guide 托管的版本已知损坏。修复步骤从Kernel - Add中移除 NullCPUPowerManagement同时删除EFI/OC/Kexts下对应的 kext 文件在Kernel - Emulate下启用DummyPowerManagement。关于DummyPowerManagementAMD/fx.md 明确说明它是 NullCPUPowerManagement 的新替代方案AMD CPU 系统由于没有原生电源管理必须开启Intel 平台的 HEDT 示例如 broadwell-e.md则保持No。clover-conversion/clover-efi.md 也印证了这一点Clover 时代的 NullCPUPowerManagement 在 OpenCore 中已被整合为Kernel - Emulate - DummyPowerManagement。15h/16h 老 AMD CPUData Privacy 界面后重启AMD 15h/16hBulldozer/Piledriver 及衍生CPU 在 Data Privacy 界面后反复重启需要参考 insanelymac 上 AMD Mojave 内核开发帖 UPDATE 2 之后的方案处理该帖对 AMD 内核打补丁的演进过程有完整记录。这属于 AMD 内核补丁历史问题若你的平台较新Zen 及以后通常不会遇到。登录前冻结TSC 失同步常规系统CpuTscSyncmacOS 登录界面之前冻结是 TSC时间戳计数器不同步的典型表现多数系统安装 CpuTscSync 将其收录为关键词。Skylake-X 特殊场景TSCAdjustResetSkylake-X如 i9 7980XE的不少固件含 Asus、EVGA不会把 TSC 同步写入所有核心需要在冷启动和唤醒时用 TSCAdjustReset使用方法解压 kext在 Finder 中显示包内容Show Package Contents进入Contents - Info.plist修改IOKitPersonalities - IOPropertyMatch - IOCPUNumber为你的CPU 线程数减 1从 0 开始计数。例如 18 核 36 线程的 i9 7980XE 应填35。最直观的确认方式看安装器是否卡在两个经典界面如 asus-tsc.png 与 asus-tsc-2.png 所示的 TSC 相关冻结画面特征是进度条/界面无响应且无错误日志。MediaKit 空间不足与磁盘工具无法抹盘MediaKit reports not enough space该报错源于EFI 分区过小Windows 默认创建 100MB EFI而 macOS 期望 200MB。两条出路扩容 EFI 分区到 200MB操作方式请自行检索格式化整块磁盘而非仅格式化分区。注意磁盘工具Disk Utility默认只显示分区按Cmd/Win 2或点击视图按钮切换为显示所有设备Show All Devices才能看到整块磁盘并对其执行格式化。对应界面可参考 Default.png默认视图与 Showalldevices.pngCmd2 视图。DiskUtility 无法抹盘failing to erase按可能性从高到低排查格式化的是分区而非整盘——见上文 MediaKit 问题磁盘工具首次抹盘失败的重试 bug再点一次抹盘即可BIOS 中 SATA Hot-plug热插拔导致问题尝试关闭该选项固件过旧将硬盘固件更新到最新硬盘本身损坏换盘验证。SATA 硬盘不出现在磁盘工具中确认 BIOS 中SATA Mode 为 AHCI各平台示例均将 AHCI 列为安装前置条件如 AMD/zen.md若 macOS 不支持你的 SATA 控制器使用 CtlnaAHCIPort.kext.zip 强制启用非官方 SATA 控制器非常老旧的 SATA 控制器可尝试 AHCIPortInjector.kext。卡在2 分钟剩余2 minutes remaining该阶段 macOS 正在向 NVRAM 写入开机所需的关键变量任何 NVRAM 问题都会让安装在此停滞典型画面见 2-min-remaining.jpeg。按平台选择解法Intel 300 系列如 Z390安装 SSDT-PMC仓库 Misc-files 之外另提供编译产物用于解锁被固件隐藏的 PMC NVRAM 区域其他平台在config.plist中设置以下 NVRAM 相关选项LegacyEnable - YES LegacyOverwrite - YES WriteFlash - YES其中WriteFlash允许 OpenCore 向固件 NVRAM 写入AMD/zen.md 将其列为 NVRAM 写入开关LegacyEnable/LegacyOverwrite则负责老式 NVRAM 变量区的读写与覆盖。无法联系恢复服务器The recovery server cannot be contactedWindows/Linux 下制作的安装 U 盘通常是基于恢复模式recovery-based只有一小部分安装器本体在磁盘上其余内容在安装过程中从 Apple 服务器下载。仓库不推荐全量安装器镜像的原因是 HFS 驱动不稳定、相关工具易造成数据损坏。排查顺序确认网络连通在安装器的Utilities菜单中打开Network Utility检查网卡是否被识别网卡不出现→ 缺少对应网卡 kext请参考 Ethernet Kexts 与 Finding your hardware 选择正确的驱动网卡已出现→ 在安装器终端执行连通性测试ping -c3 www.google.com无响应网络或 kext 异常可尝试换用旧版 kext新版可能存在兼容性 bug有响应问题在 Apple 服务器端只能改日再试。界面参考check-network.png检查网卡与 ping.pngPing 测试。Big Sur 下键鼠失效IOHIDFamily 内核补丁Core 2 Duo / 2010 年及更早的老平台在 Big Sur 下 USB 口有电但 HID 键鼠不工作需要对com.apple.iokit.IOHIDFamily打补丁原始出处为 applelife.ru 讨论帖。在config.plist - Kernel - Patch添加KeyTypeValueBaseString_isSingleUserCountInteger1EnabledBooleanTrueFindData空IdentifierStringcom.apple.iokit.IOHIDFamilyLimitInteger0MaskData空MaxKernelString空MinKernelString20.0.0ReplaceDataB801000000C3ReplaceMaskData空SkipInteger0该补丁用MinKernel: 20.0.0限定仅在 Big Sur 及更新系统上生效Replace: B801000000C3是将_isSingleUser相关检查替换为直接返回成功的机器码从而恢复 HID 设备枚举。Your Mac needs a firmware updateSMBIOS 表过时该提示通常意味着SMBIOS 表信息过旧无法满足 APFS 卷安装要求。依次核对PlatformInfo - Automatic已启用UpdateSMBIOSMode设为Create用新分配的EfiReservedMemoryType替换 SMBIOS 表同时确保CustomSMBIOSGuid为关闭Dell 与 VAIO 例外需要CustomSMBIOSGuid开启且UpdateSMBIOSMode设为Custom——两者必须成对出现AMD/zen.md 说明该组合会禁用向非 Apple 系统注入 SMBIOS可能破坏 Bootcamp 兼容性谨慎使用使用当前 macOS 版本支持的 SMBIOS不要依赖-no_compat_check硬闯使用最新版 OpenCore。若仍报错说明 OpenCore 自身残留了过时的 SMBIOS 信息建议换用相近的 SMBIOS 验证完整的机型选择指南见 Choosing the right SMBIOS其中详细解释了 CPU 类型、GPU 类型iGPU 是否存在、XCPM 支持列表等选型因素——这直接决定你换用哪个 SMBIOS 才不会引入新的电源管理或显示问题。排错路线总结症状首要怀疑对象首选动作安装器语言非英文NVRAMprev-lang:kbd改656e2d55533a30并重置 NVRAM安装器已损坏证书过期改系统日期为0901000019卡IOConsoleUsersGPU 初始化关 CSM / 校验 ig-platform-id /-igfxmlr笔记本黑屏背光/核显装 SSDT-PNLF /-igfxblrNavi 黑屏AGDP 板卡检查agdpmodpikera/ MSI VBIOS 补丁30 秒冻结NullCPUPowerManagement换DummyPowerManagement登录前冻结TSC 失同步CpuTscSync / TSCAdjustResetSkylake-X2 分钟剩余NVRAM 写入SSDT-PMC300 系/ WriteFlash 等无法联系恢复服务器网络/kextNetwork Utility 定位 ping -c3Big Sur 键鼠失效IOHIDFamilyKernel - Patch打补丁需固件更新提示SMBIOS 过旧UpdateSMBIOSMode - Create或换 SMBIOS以上所有修复均围绕 OpenCore 的四个核心配置区块——NVRAM、DeviceProperties、Kernel、PlatformInfo展开对应的完整示例配置可对照 config.plist 各平台文档 与 config-laptop.plist 下的具体平台文件按需取用。排错时建议每次只改一个变量并在引导选择器中重置 NVRAM 后再验证这样能最大程度避免多个修复相互掩盖根因。赞分享文档教程【免费下载链接】OpenCore-Install-GuideRepo for the OpenCore Install Guide项目地址https://gitcode.com/gh_mirrors/op/OpenCore-Install-Guide点击查看免费下载相关推荐AI前端设计范式革命从平庸模板到设计系统的智能跃迁AI前端设计范式革命从平庸模板到设计系统的智能跃迁 在当今AI辅助开发的时代前端开发者面临着一个看似矛盾的困境大语言模型虽然能够快速生成代码但其输出的UAI 技能前端设计系统从数据备份到AI训练WeChatMsg的三重价值探索从数据备份到AI训练WeChatMsg的三重价值探索 在数字生活日益丰富的今天微信聊天记录已不仅仅是简单的文字交流它承载着我们的情感记忆、工作沟通和生活轨OpenStack Nova调度器工作原理揭秘从请求到资源分配的完整流程OpenStack Nova调度器工作原理揭秘从请求到资源分配的完整流程 OpenStack Nova调度器是OpenStack云计算平台的核心组件之一负责后端云原生虚拟化上一篇Kodi IPTV Simple 配置难题全解析5步搞定直播卡顿问题下一篇Android-Smart-Login进阶自定义登录系统的实现与优化指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考