扫二维码与项目经理沟通
我们在微信上24小时期待你的声音
解答本文疑问/技术咨询/运营咨询/技术建议/互联网交流
OpenCore 参数详解
2026-06-24 19:54 栏目： 技术学堂 查看()
基于 OC 0.9.x~1.0 稳定版官方规范，分 ACPI / Booter / DeviceProperties / Kernel / Misc / NVRAM / PlatformInfo / UEFI 八大主模块，所有子项、作用、取值、适用场景全部说明，黑苹果 Intel/AMD 通用。
c
onfig.plist主界面总览
一、ACPI（硬件电源 / 设备表核心模块，解决 EC、CPU、USB、时钟冲突）
ACPI 分为 4 个子数组：Add / Delete / Patch / Quirks
1. ACPI -> Add（加载自定义 SSDT/DSDT 补丁文件）
每条字典 4 个参数：
Comment：备注文字，仅给人看，无功能
Enabled：true = 启用该 ACPI 表，false = 跳过加载
Path：文件路径，文件放在 EFI/OC/ACPI/，如 SSDT-PLUG.aml
TableSizeLimit：一般填 0 自动适配，极少机型限制表大小
常用 SSDT 作用
SSDT-PLUG：Intel CPU 电源管理，解锁睿频
SSDT-CPUR：AMD 锐龙 CPU 修复
SSDT-EC-USBX：修复嵌入式控制器、USB 供电
SSDT-AWAC：新主板时钟冲突修复（300/400/500 系）
SSDT-PMC：开启主板原生 NVRAM
2. ACPI -> Delete（屏蔽主板原生冲突 ACPI 表）
屏蔽 BIOS 自带错误表，避免 macOS 卡死、睡眠失败
Comment：备注
Enabled：开关
OemTableId：8 字符表 ID（如 SSDT-EC）
TableLength：匹配表长度，0 = 忽略长度只匹配 ID
TableSignature：签名（DSDT/SSDT/FACP 等）
3. ACPI -> Patch（二进制在线修改 ACPI 代码，重命名设备、修复寄存器）
用于改名：_INI→XINI、_STA→XSTA、_PRW→XPWR 等，每条补丁参数：
Comment：备注
Enabled：开关
Base / BaseMask：匹配起始地址偏移
Limit：搜索字节长度
Find：十六进制待替换字节
Replace：替换后的十六进制字节
ReplaceMask：掩码，无需修改的字节填 FF
TableLength / TableSignature / OemTableId：限定补丁作用的表
4. ACPI -> Quirks（ACPI 全局修复开关，整机通用 bug 修复）
| 参数 | 作用 | 推荐值 |
|---|---|---|
| Disable _DSM | 屏蔽主板错误 DSM 方法，声卡 / USB 异常必开 | true |
| Disable _INI | 禁用设备初始化冲突，笔记本常用 | true |
| ForceSecureBootScheme | 仿苹果安全启动，新 macOS 需要 | false |
| FadtEnableReset | 修复重启失效、循环重启 | Intel true，AMD false |
| NormalizeHeaders | 标准化 ACPI 表头，解决引导崩溃 | true |
| RebaseRegions | 重定位 ACPI 内存区域，老主板必开 | true |
| ResetHpet | 重置高精度计时器，解决卡顿、睡眠唤醒黑屏 | true |
| ResetLogoStatus | 屏蔽开机 logo 冲突，笔记本 | false |
| SkipAslCheck | 跳过 ACPI 语法校验，自制 SSDT 报错时开启 | false |
二、Booter（内存映射模块，替代旧版 AptioMemoryFix，解决内存卡死、2048 卡 logo）
1. Booter -> MmioWhitelist（放行 PCI 内存地址，新主板 Resize BAR、独显直通必加）
单条字典：
Address：十六进制 PCI 内存地址
Comment：备注显卡 / 南桥地址
Enabled：true 放行该地址
2. Booter -> Quirks（内存核心修复，最关键模块之一）
| 参数 | 功能 | 适用平台 |
|---|---|---|
| AvoidRuntimeDefrag | 防止运行时内存碎片，所有机器必须 true | 全平台 true |
| DevirtualiseMmio | 解除 MMIO 虚拟锁，解决卡 2048、独显黑屏 | 全平台 true |
| DisableSingleUser | 禁用单用户模式限制 | false |
| DisableVariableWrite | 屏蔽 NVRAM 写入，无原生 NVRAM 主板（300 系）true | 300 系 true，400+false |
| EnableWriteUnprotector | 解锁 UEFI 写保护，修复内存锁死 | 全平台 true |
| ForceSecureBootScheme | 安全启动模拟，配合 SecureBootModel | false |
| ProvideCustomSlide | 自定义 Slide 内存偏移，日志提示需要再开 | 报错OCABC时 true |
| RebuildAppleMemoryMap | 生成 macOS 兼容内存图，笔记本 / 品牌机必开 | 笔记本 true，台式酌情 |
| ResizeAppleGpuBars | Resize BAR 支持：-1 关闭，0 修复显卡条带 | 开启 ReBAR 填 0，否则 - 1 |
| SetupVirtualMap | 修复虚拟地址映射，老主板 Sandy/Ivy true | 2 代 / 3 代 Intel true |
| SyncRuntimePermissions | 同步内存权限，新版 OC 强制 true | 全平台 true |
| ProtectUefiServices | 保护 UEFI 服务不被固件覆盖，Z490/B460 必开 | 400 系 Intel true |
三、DeviceProperties（PCI 设备属性注入，显卡 / 声卡 / 网卡核心配置）
分 Add（注入属性）、Delete（删除原生属性，极少用）
DeviceProperties -> Add
键：PCI 完整设备路径（Hackintool 可复制）
示例：PciRoot(0x0)/Pci(0x2,0x0) 核显、PciRoot(0x0)/Pci(0x1B,0x0) 声卡
子字典常用注入参数：
1.Intel 核显专用
AAPL,ig-platform-id：帧缓冲 ID，控制输出、硬解（Data 十六进制 base64）
device-id /vendor-id：伪装显卡 ID
framebuffer-conX-enable：开启多显示器输出
framebuffer-stolenmem：分配核显显存
2.声卡 AppleALC
layout-id：声卡布局 ID（数字 1~100，Data 格式）
device-type：仿苹果 HDA 音频设备
3.AMD 独显
AAPL,slot-name：伪装显卡插槽
hda-gfx：开启显卡 HDMI 音频
4.网卡
device-type：仿苹果以太网 / WiFi 设备
DeviceProperties -> Delete
仅当主板自带错误 PCI 属性时使用，填入设备路径 + 要删除的属性名数组，99% 机器留空。
四、Kernel（内核模块：驱动注入、内核补丁、屏蔽原生驱动、CPU 伪装）
4 个子项：Add / Block / Emulate / Patch
1. Kernel -> Add（注入 Kext 驱动，加载顺序严格！顺序错误直接崩溃）
每条 kext 配置：
Comment：驱动备注
Enabled：true 启用
ExecutablePath：kext 内二进制路径，一般 Contents/MacOS/xxx
PlistPath：驱动信息文件，固定 Contents/Info.plist
BundlePath：EFI/OC/Kexts 下驱动文件夹名
强制加载顺序（不能乱）
Lilu.kext（底层补丁框架，所有驱动依赖）
VirtualSMC.kext（SMC 传感器、机型仿真）
WhateverGreen.kext（显卡修复）
AppleALC.kext（声卡）
WhateverGreen/AppleALC 等插件（放在主驱动后）
2. Kernel -> Block（屏蔽 macOS 自带原生驱动，防止冲突）
常用屏蔽：
com.apple.driver.AppleIntelCPUPowerManagement：AMD 锐龙必须屏蔽
com.apple.iokit.IOEthernetAVBController：有线网卡冲突屏蔽
参数：Arch (amd64)、Comment、Enabled、Identifier（驱动包名）
3. Kernel -> Emulate（CPU 伪装，AMD 全平台必须配置，Intel 不用）
CpuidMask：CPUID 掩码，AMD Zen 填 0x00FFFFFF
CpuidData：伪装 Intel CPUID 十六进制数据
MaxKernel / MinKernel：限定补丁生效 macOS 版本
DisableIoMapper：AMD 开启，关闭 IO 内存映射冲突 true
4. Kernel -> Patch（内核二进制补丁，AMD 必备，Intel 少量需要）
每条补丁格式同 ACPI Patch（Find/Replace/ 掩码）
AMD 必打补丁：内核同步补丁、APIC 修复、电源管理补丁
Intel 常用补丁：XCPM 电源、限制 PCIe 版本
5. Kernel -> Quirks（内核全局开关）
| 参数 | 作用 |
|---|---|
| AppleXcpmCfgLock | 解锁 XCPM 电源管理，Intel 台式 true，笔记本 false |
| AppleXcpmExtraMsrs | 解锁更多 CPU 寄存器，12/13 代大小核必 true |
| AppleXcpmForceBoost | 强制持续睿频，游戏本可选 true |
| CustomSMBIOSGuid | 自定义 SMBIOS GUID，平台 ID 冲突开启 |
| DisableIoMapper | AMD 锐龙必须 true，Intel false |
| ForceSecureBootScheme | 安全启动兼容 |
| ResizeAppleGpuBars | 和 Booter 同步，ReBAR 显卡修复 |
五、Misc（OC 引导器自身界面、调试、安全设置）
1. Misc -> Boot（引导菜单设置）
PickerMode：引导界面风格
Builtin：OC 原生图形菜单（推荐）
External：第三方 GUI（OpenCanopy）
Text：纯文字黑白菜单
PickerAttributes：菜单功能位掩码
0x01：隐藏苹果 logo
0x02：隐藏恢复分区
0x20：鼠标支持
PickerVariant：OpenCanopy 主题文件夹名
ShowPicker：true 显示启动菜单，false 直接进默认系统
Timeout：菜单等待秒数，0 无限等待，-1 直接启动
HideAuxiliary：隐藏 Recovery、Windows 工具分区 true
LauncherOption：Full/Short，引导器路径记录
2. Misc -> Debug（调试日志，排错专用，日常安装完关闭）
AppleDebug：开启苹果内核调试输出
DisableWatchDog：内核崩溃不自动重启 true
LogModules：日志输出模块，全部填 true 方便排错
Target：日志输出级别，0x0F 全部输出，日常 0x00 关闭
SerialInit：串口日志，台式机 false
3. Misc -> Security（安全启动、签名校验，新版 macOS 强制规范）
AllowUnsigned：允许未签名 kext，安装系统 true，日常 false
BootProtect：引导分区保护，None/Self/Restore，推荐 Self
SecureBootModel：安全启动仿真
Disabled：关闭（老系统 / AMD）
Default：默认苹果机型安全策略（13+macOS）
j137/iMac20,1 等：对应机型完整安全启动
Vault：文件校验保护，Optional 可选，Strict 严格校验
4. Misc -> Tools（引导工具，如 ResetNVRAM、SSDTTime，按需添加）
每条填入 EFI/OC/Tools 下 efi 文件名，Enabled=true，菜单显示工具入口。
六、NVRAM（固件变量、启动参数 boot-args、SIP 开关）
1. NVRAM -> Add（写入 NVRAM 持久变量，两大 UUID 分区）
① UUID：7C436110-AB2A-4BBB-A880-FE41995C9F82（核心启动参数区）
boot-args：启动命令行参数，空格分隔
常用参数：
-v：啰嗦模式，开机显示文字日志（排错必开）
keepsyms=1：内核崩溃打印符号
agdpmod=pikera：AMD 5000/6000 系显卡修复
alcid=xx：声卡 layout-id（也可写 DeviceProperties）
wegnoegpu：屏蔽核显，独显机型
debug=0x100：关闭看门狗
csr-active-config：SIP 系统完整性保护（Data 格式）
00000000：完整开启 SIP（推荐日常）
03000000：关闭 SIP（修改系统文件用）
prev-lang:kbd：键盘语言，中文 zh-CN:252
② UUID：4D1EDE05-38C7-4A6A-9CC6-4BCCA8B38C14（UI 界面变量）
UIScale：菜单缩放，高分辨率屏填 2，1080P 填 1
2. NVRAM -> Delete（删除主板原生 NVRAM 冲突变量）
填入变量名数组，清空错误启动参数，安装前清空 boot-args 常用。
七、PlatformInfo（SMBIOS 机型仿真，最影响睡眠、声卡、电源、APP Store）
1. PlatformInfo -> Generic（通用自动生成，新手优先）
AdviseWindows：true 自动给 Windows 生成引导信息
MaxBIOSVersion：限制 BIOS 版本，屏蔽更新弹窗
MLB / ROM / Serial / UUID：三码（序列号、主板序列号、UUID、MAC），必须随机生成，重复无法登录 App Store
SpoofVendor：伪装主板厂商，防止序列号冲突
SystemProductName：机型代号（iMac20,1 / MacbookPro16,1 / MacPro7,1）
SystemSerialNumber：序列号
SystemUUID：系统唯一 ID
2. PlatformInfo -> UpdateDataHub / UpdateNVRAM / UpdateSMBIOS / UpdateSMBIOSMode
全部填 true，自动把三码同步到所有固件区域
UpdateSMBIOSMode：Create（新建）/ Overwrite（覆盖原生）/ Custom 自定义，推荐 Create
机型选择规则
Intel 台式带核显：iMac20,1 /iMac19,1
Intel 纯独显无核显：MacPro7,1
AMD 锐龙全平台：MacPro7,1
笔记本：对应年份 MacBookPro（如 16,3=12 代笔记本）
八、UEFI（UEFI 驱动、启动服务、USB、输出修复）
1. UEFI -> Drivers（加载 EFI 底层驱动，必须全部放入 EFI/OC/Drivers）
必备驱动：
OpenRuntime.efi：内存修复核心（必装）
HfsPlus.efi：读写 macOS HFS 分区（必装）
FwRuntimeServices.efi：NVRAM 支持
可选：
XhciDxe.efi：老主板 USB3 修复
Ps2KeyboardDxe.efi：老式 PS2 键盘
OpenCanopy.efi：图形引导界面
2. UEFI -> Output（屏幕输出修复，笔记本花屏、分辨率异常）
ClearScreenOnModeSwitch：切换分辨率清屏 true
IgnoreTextOutputSwitch：忽略文字输出切换
UIScale：菜单缩放（和 NVRAM UIScale 同步）
3. UEFI -> Quirks（UEFI 底层修复开关）
ExitBootServicesDelay：退出引导服务延迟，笔记本填 5000~10000
ForceBooterSignature：强制引导签名，新安全启动 true
IgnoreInvalidFlexRatio：忽略无效 CPU 倍频，12/13 代 true
ReleaseUsbOwnership：释放 USB 控制器给 macOS，所有机型 true（解决 USB 开机失效）
ResizeAppleGpuBars：全局 ReBAR 开关
4. UEFI -> Protocols（协议屏蔽，极少修改）
屏蔽主板冲突 UEFI 协议，99% 场景留空。
补充核心通用知识点
1.加载优先级
UEFI 驱动 → Booter 内存修复 → ACPI 表加载 / 补丁 → Kernel 内核 + Kext → NVRAM 变量 → PlatformInfo 机型仿真 → Misc 引导菜单
2.三码规范
PlatformInfo 里 Serial/MLB/ROM/UUID 必须唯一，在线生成器随机获取，重复会无法登录 iCloud
3.AMD vs Intel 核心区别
AMD：Kernel Emulate 开启、屏蔽 AppleXcpm、全套内核补丁、机型 MacPro7,1
Intel：XCPM 电源 Quirk 开启、无需 CPU 仿真、iMac 机型
4.排错核心参数
NVRAM boot-args 添加 -v keepsyms=1，Misc Debug Target=0x0F，查看日志定位卡 logo、崩溃问题
郑重申明：宁波优景摄影以外的任何单位或个人，不得使用该案例作为工作成果展示！
