引导参数

-wegnoigpu禁用igpu

-wegdbg启用调试打印（在 DEBUG 二进制文件中可用）。
-wegoff禁用WhateverGreen。
-wegbeta在不受支持的操作系统版本上启用 WhateverGreen（默认情况下启用 12 及以下版本）。
-wegnoegpu禁用所有外部 GPU（或添加 disable-gpu每个 GFX0 的属性）。
-wegnoigpu禁用内部 GPU（或添加 disable-gpuIGPU 的财产）
-wegswitchgpu在安装外部 GPU 时禁用内部 GPU（或添加 switch-to-external-gpuIGPU 的财产）
-radvesa完全禁用 ATI/AMD 视频加速。
-rad24强制执行 24 位显示模式。
-raddvi启用 DVI 发射器校正（290X、370 等需要）。
-radcodec强制在 AMDRadeonVADriver 中使用欺骗的 PID
radpg=15禁用几种电源门控模式（请参阅常见问题解答，佛得角 GPU 所需）。
agdpmod=vit9696禁用检查 board-id（或添加 agdpmod外部 GPU 的属性）。
agdpmod=pikera替换 board-id和 board-ix
agdpmod=ignore禁用 AGDP 补丁（ vit9696,pikeravalue 是外部 GPU 的隐式默认值）
ngfxgl=1引导参数（和 disable-metal属性）禁用对 NVIDIA 的 Metal 支持
ngfxcompat=1引导参数（和 force-compat属性）忽略 NVDAStartupWeb 中的兼容性检查
ngfxsubmit=0引导参数（和 disable-gfx-submit属性）在 10.13 上禁用界面卡顿修复
-ngfxdbg启动参数以启用 NVIDIA 驱动程序错误日志记录
gfxrst=1更喜欢在第二个启动阶段绘制 Apple 标志，而不是帧缓冲区复制。
gfxrst=4在第二个引导阶段禁用帧缓冲区初始化交互。
igfxframe=frame将专用的帧缓冲区标识符注入 IGPU（仅用于测试目的）。
igfxsnb=0为 Sandy Bridge CPU 禁用 IntelAccelerator 名称修复。
igfxgl=1引导参数（和 disable-metal属性）以禁用 Intel 上的 Metal 支持。
igfxmetal=1引导参数（和 enable-metal属性) 以强制启用 Intel 上的 Metal 支持以进行离线渲染。
igfxpavp=1引导参数（和 igfxpavp属性）强制启用 PAVP 输出
igfxfw=2引导参数（和 igfxfw属性）强制加载 Apple GuC 固件
-igfxvesa禁用英特尔图形加速。
-igfxnohdmi引导参数（和 disable-hdmi-patches) 以禁用数字声音的 DP 到 HDMI 转换补丁。
-igfxtypec强制为 Type-C 平台进行 DP 连接。
-cdfon（和 enable-hdmi20属性）以启用 HDMI 2.0 补丁。
-igfxdump将 IGPU 帧缓冲区 kext 转储到 /var/log/AppleIntelFramebuffer_X_Y（在调试二进制文件中可用）。
-igfxfbdump在 IOService:/IOResources/WhateverGreen 将本机和修补的帧缓冲表转储到 ioreg
applbkl=0引导参数（和 applbkl属性）禁用 IGPU 的 AppleBacklight.kext 补丁。如果是自定义 AppleBacklight 配置文件，请阅读此处。
-igfxmlr引导参数（和 enable-dpcd-max-link-rate-fix属性）以应用最大链接速率修复。
-igfxhdmidivs引导参数（和 enable-hdmi-dividers-fix属性）以修复在 SKL、KBL 和 CFL 平台上建立具有更高像素时钟速率的 Intel HDMI 连接的无限循环。
-igfxlspcon引导参数（和 enable-lspcon-support属性）以启用对板载 LSPCON 芯片的驱动程序支持。
-igfxi2cdbg用于在 I2C-over-AUX 事务中启用详细输出的引导参数（仅用于调试目的）。
igfxagdc=0引导参数（ disable-agdc设备属性）以禁用 AGDC。
igfxfcms=1引导参数（ complete-modeset设备属性）强制在 Skylake 或 Apple 固件上完成模式设置。
igfxfcmsfbs=引导参数（ complete-modeset-framebuffers设备属性）来指定必须强制执行完整模式集的连接器索引。每个索引是一个字节一个 64 位字；例如，值 0x010203指定连接器 1、2、3。如果连接器是不在列表中，驱动程序的逻辑用于确定是否需要完整的模式集。经过 -1禁用。
igfxonln=1引导参数（ force-online设备属性）强制在所有显示器上处于在线状态。
igfxonlnfbs=MASK引导参数（ force-online-framebuffers设备属性）来指定对其强制执行在线状态的连接器的索引。格式类似于 igfxfcmsfbs.
wegtree=1引导参数（ rebuild-device-tree属性）强制在 Apple FW 上重命名设备。
igfxrpsc=1引导参数（ rps-control属性）以启用 RPS 控制补丁（提高 IGPU 性能）。
-igfxcdc引导参数（ enable-cdclk-frequency-fix属性）以支持 ICL 平台上的所有有效核心显示时钟 (CDCLK) 频率。
-igfxdvmt引导参数（ enable-dvmt-calc-fix属性）修复因英特尔 ICL 平台上的 DVMT 预分配内存量计算错误而导致的内核崩溃。
-igfxblr引导参数（和 enable-backlight-registers-fix属性）修复 KBL、CFL 和 ICL 平台上的背光寄存器。
-igfxmpc引导参数（ enable-max-pixel-clock-override和 max-pixel-clock-frequency属性）以增加最大像素时钟（作为修补 CoreDisplay.framework 的替代方法）。
-igfxbls引导参数（和 enable-backlight-smoother属性）使亮度过渡在 IVB+ 平台上更平滑。阅读说明书
-igfxdbeo引导参数（和 enable-dbuf-early-optimizer属性）修复 ICL+ 平台上的显示数据缓冲区 (DBUF) 问题。
applbkl=3引导参数（和 applbkl属性）启用 AMD Radeon RX 5000 系列显卡的 PWM 背光控制，请阅读此处。

引导位置添加或删除

Clover[EFI/Clover/config.plist]

OpenCore[EFI/OC/config.plist]

以下为补充更新的常用启动参数

启动参数	目的
-v	启用详细模式。将 Apple 徽标下方的进度条替换为启动过程的文本输出。有助于跟踪安装进度或启动时的情况。我们建议使用此启动参数。完成安装和安装后，您可以禁用此启动参数。
-s	启用单用户模式。在终端模式下启动 macOS。
-x	启用安全模式。使用最少的系统扩展和功能启动 macOS。如果 OpenCore Legacy Patcher 应用的根补丁不再起作用或者应用补丁后 macOS 无法启动，则可用于恢复这些补丁。
-f	启用无缓存启动。仅适用于 Clover Bootloader。OpenCore 使用中的其他选项`Kernel>Scheme>KernelCache`。请更改`Auto`为`Cacheless`。仅适用于 OS X 10.6 至 OS X 10.9。
调试=0x100	这将禁用 macOS 的看门狗，有助于防止内核崩溃时重新启动。
keepsyms=1	这是 debug=0x100 的配套设置，它告诉操作系统在内核崩溃时也打印符号。这可以为了解恐慌本身的原因提供一些更有用的见解。
无根=0	启用无根模式仅在优胜美地有效。
幻灯片=0
飞镖=0	禁用 VT-d 删除 OEM DMAR 表。 `DisableIoMapper`被 OpenCore 的Quirk取代。
CPU=1	启用单 CPU 核心模式。
-xcpm	启用 XCPM 仅在 OS X 10.11 及更高版本上需要
kext-dev-mode=1	允许加载未签名的 kext 仅在优胜美地有效
-disablegfxfirmware	避免固件加载无限循环仅适用于 IGPU。
-no_compat_check	禁用 macOS 兼容性检查。允许使用不受支持的 SMBIOS/board-ids 启动 macOS。在使用旧的 SMBIOS 时需要在旧硬件上启动新的 macOS 版本，旧的 SMBIOS 被 Apple 视为已过时。使用此启动参数时，无法进行全新安装。此外，如果此启动参数处于活动状态，则无法安装系统更新。
npci=0x2000	禁用与 kIOPCIConfiguratorPFM64 相关的 PCI 调试。所有 HEDT 和一些 500 和 600 系列主板都需要。由于存在与 PCI 通道相关的 IRQ 冲突，此问题也可以修复“PCI 启动配置开始”时卡住的问题。此启动标志可能会导致不需要它的系统挂起。请勿`npci=0x2000`与`npci=0x3000`一起使用
npci=0x3000	所有 HEDT 和一些 500 和 600 系列主板都需要。 `npci=0x2000`不兼容时必需由于存在与 PCI 通道相关的 IRQ 冲突，此问题也可以修复“PCI 启动配置开始”时卡住的问题。此启动标志可能会导致不需要它的系统挂起。请勿`npci=0x3000`与`npci=0x2000`一起使用
nvda_drv=1	启用 NVIDIA 驱动程序的加载类似于 Clover 的 NVIDIAWeb
nv_disable=1	禁用 NVIDIA 驱动程序的加载。如果您拥有 NVIDIA GPU，并且在安装后无法进入安装屏幕或无法启动到桌面，请使用此启动参数禁用 NVIDIA 驱动程序并在安装后安装驱动程序。

Kexts 特定

Lilu

-liludbg	启用调试打印。需要 Lilu 的 DEBUG 版本。
-liludbgall	在 Lilu 和所有加载的插件中启用调试打印（在 DEBUG 二进制文件中可用）。
-liluoff	禁用莉露。使用此启动参数时，所有依赖 Lilu 的其他 kext 都不会被注入。使用此启动参数时请小心。强烈建议不要使用此启动参数。
-liluuseroff	禁用 Lilu 用户修补程序（例如用于 dyld_shared_cache 操作）。
-liluslow	启用旧版用户修补程序。
-lilulowmem	禁用内核解包（在恢复模式下禁用 Lilu）。
-lilubeta	在不受支持的 macOS 版本上启用 Lilu（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-lilubetaall	在未受支持的操作系统版本上启用 Lilu 和所有加载的插件（请小心使用）。
-liluforce	无论模式、操作系统、安装程序或恢复如何，均可启用 Lilu。
liludelay=1000	每次打印后增加 1 秒（100 毫秒）延迟以进行故障排除。
lilucpu=N	欺骗 CPU 生成。 N指的是以下英特尔代数： 4. 桑迪桥 5. Ivy Bridge 6. 哈斯韦尔 7 - 布罗德韦尔 8. Skylake 9. 卡比湖 10 - 咖啡湖
liludump=N	让 Lilu DEBUG 版本在 N 秒后转储日志到 /var/log/Lilu_VERSION_KERN_MAJOR.KERN_MINOR.txt

虚拟SMC

-vsmcdbg	启用调试打印。需要 VirtualSMC 的 DEBUG 版本。
-vsmcoff	禁用所有 Lilu 增强功能。如果没有此 kext，由于缺少 SMC 模拟，任何 macOS/OS X 版本都无法启动。使用此启动参数时请小心。强烈建议不要使用此启动参数。
-vsmcbeta	在不受支持的 macOS 版本上启用 VirtualSMC（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-vsmcrpt	将丢失的 SMC 密钥报告到系统日志。
-vsmccomp	如果找到，则优先选择现有的硬件 SMC 实现。
vsmcgen=X	强制暴露 X-gen SMC 设备（支持 1 和 2）。
vsmchbkp=X	设置 HBKP 转储模式（0 - 关闭，1 - 正常，2 - 不加密）。
vsmcslvl=X	设置值序列化级别（0 - 关闭，1 - 正常，2 - 包含敏感数据（默认））。
smcdebug=0xff	启用 AppleSMC 调试信息打印。
看门狗=0	禁用看门狗定时器。如果意外重启则需要。

任何绿色

全球的

-wegdbg	启用调试打印。需要使用 WhateverGreen 的 DEBUG 版本
-韦戈夫	禁用 WhateverGreen 禁用此启动参数可能会导致几个与图形相关的问题。使用此启动参数时请小心。强烈建议不要使用此启动参数。
-wegbeta	在不受支持的 macOS 版本上启用 WhateverGreen（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-cdfon	通过 WhateverGreen.kext 启用 CoreDisplayFixup 功能。在 IGPU 和 dGPU 上启用 HDMI 2.0 补丁。修补`CheckTimingWithRange`以`CoreDisplay.framework`跳过像素时钟的验证。这可防止 60FPS 或更高的 UHD 分辨率 HDMI 出现黑屏。 *配备 4K/UHD/QHD 显示器的笔记本电脑和 OEM 系统必需。* 如果您收到“gIOScreenLockState3 错误”，则需要使用此属性。在 macOS Big Sur (11.x) 及更高版本上不起作用。
wegtree=1	强制在 Apple FW 上重命名设备。
gfxrst=1	更喜欢在第二次启动阶段绘制 Apple 徽标，而不是复制帧缓冲区。
gfxrst=4	在第二启动阶段禁用帧缓冲区初始化交互

主板编号

启动参数	目的
agdpmod=vit9696	禁用 board-id 检查。修复黑屏
agdpmod=pikera	修复 macOS 完成加载时出现黑屏的问题。需要基于 Navi 的 AMD GPU。
agdpmod=忽略	禁用 AGDP 补丁

GPU切换

-wegnoegpu	禁用所有外接 GPU（NVIDIA 和 AMD）。主要用于双 GPU 笔记本电脑。已通过 DSDT 和 SSDT 修补 ACPI 和 dGPU 的用户，无需使用此启动参数。此启动参数是一个临时解决方案。建议您修补 DSDT 和相关的 SSDT，以禁用独立显卡，从而实现更好的电源管理并提升电池性能。
-wegnoigpu	禁用内部 GPU
-wegswitchgpu	安装外部 GPU 时禁用内部 GPU。

NVIDIA 显卡

-ngfxdbg	启用 NVIDIA 驱动程序错误日志记录
ngfxgl=1	禁用 NVIDIA GPU 上的金属支持
ngfxcompat=1	忽略 NVDAStartupWeb 中的兼容性检查
ngfx提交=0	禁用 10.13 版界面卡顿修复

AMD 显卡

-拉德维萨	禁用 ATI/AMD 图形加速。
-rad24	强制 24 位显示模式
-raddvi	启用 DVI 发射器校正 290X、370 等必需。
-radcodec	强制在 AMDRadeonVADriver 中使用欺骗的 PID
radpg=15	修复 Radeon HD 7730/7750/7770/R7 250/R7 250X 的初始化禁用多种电源门控模式

英特尔显卡

igfxframe=框架	将专用的帧缓冲区标识符注入 IGPU 仅用于测试目的。
igfxsnb=0	禁用 Sandy Bridge CPU 的 IntelAccelerator 名称修复。
igfxgl=1	禁用 IGPU 上的 Metal 支持。
igfxmetal=1	强制启用英特尔的 Metal 支持以进行离线渲染。
igfxpavp=1	强制启用 PAVP 输出
igfxfw=2	强制加载 Apple GuC 固件需要 300 系列芯片组。
-igfxvesa	禁用 IGPU 加速。
-igfxnohdmi	禁用 DP 到 HDMI 转换补丁以获得数字声音。
-igfxtypec	强制 Type-C 平台的 DP 连接。
-igfxdump	将 IGPU 帧缓冲区 kext 转储到 /var/log/AppleIntelFramebuffer_X_Y（可在 DEBUG 二进制文件中使用）。
-igfxfbdump	将原生和已修补的帧缓冲区表转储到 IOService:/IOResources/WhateverGreen 处的 IOReg
applbkl=0	禁用 IGPU 的 AppleBacklight.kext 补丁
-igfxmlr	修复无效的最大链接速率 IGPU 上的此属性可以修复无效的链接率，否则可能会由于除以零而导致内核崩溃。 *笔记本电脑通常需要配备清晰的显示屏和更高的刷新率。*
-igfxhdmidivs	修复了使用更高像素时钟建立 HDMI 连接时出现的无限循环问题。例如，使用 HDMI 1.4 连接到 2K/4K 显示器，否则，系统会挂起，并且插入 HDMI 电缆时内置显示器将保持黑屏。
-igfxlspcon	启用 LSPCPN 驱动程序支持，以在 IGPU 上启用 DisplayPort 至 HDMI 2.0 输出。 LSPCON 驱动程序仅适用于将 HDMI 2.0 路由至 IGPU 的笔记本电脑。如果您的 HDMI 2.0 已路由至 IGPU 并且现在正常工作，则无需启用此驱动程序，因为您的板载 LSPCON 可能已在固件中配置为在 PCON 模式下工作。此属性还可以通过 HDMI 提供 HDR 信号。
-igfxi2cdbg	在 I2C-over-AUX 事务中启用详细输出（仅用于调试目的）。
-igfxnotelemetryload	禁用 iGPU 遥测加载，这可能会导致某些笔记本电脑（例如 Chromebook）在启动时冻结
igfxagdc=0	禁用 AGDC
igfxfcms=1	强制在 Skylake 或 Apple 固件上完成模式设置。
igfxfcmsfbs=	指定必须强制执行完整模式集的连接器的索引。每个索引都是 64 位字中的一个字节；例如，值 0x010203 指定连接器 1、2、3。如果连接器不在列表中，则使用驱动程序的逻辑来确定是否需要完整模式集。传递 -1 表示禁用。
igfxonln=1	强制所有显示器处于在线状态。解决 CFL 唤醒后及之后的显示问题。
igfxonlnfbs=MASK	指定强制在线状态的连接器索引。格式类似于 igfxfcmsfbs
wegtree=1	强制在 Apple FW 上重命名设备。
igfxrpsc=1	启用RPS控制补丁（提高IGPU性能）
-igfxcdc	在 ICL 平台上启用所有有效的核心显示时钟 (CDCLK) 频率。 IGPU 上的这个属性可以用来防止由于不支持的 CD 时钟十进制频率而导致的内核故障。 *通常笔记本电脑需要具有较低的时钟频率值，例如 172.8MHz。*
-igfxdvmt	修复由于 DVMT 预分配内存量不正确而导致的内核恐慌。 IGPU 上的此属性可以修复无效的链接率，否则可能会由于除以零而导致内核崩溃。 *通常笔记本电脑需要这样做，因为 BIOS 被锁定，并且无法使用 Shell 修改变量。*
-igfxmpc	修复 HDMI 超高清分辨率 60FPS 问题 IGPU 上的这个属性可用于提高最大像素时钟限制（作为修补 CoreDisplay.framework 的替代方法）。防止 4K/UHD/QHD 显示器 @60Hz 和 HDMI 2.0 在 60Hz 或更高的 UHD 分辨率下出现黑屏。要求笔记本电脑显示器的最大链接速率无效，超过 60Hz。此属性可用于 HDMI 2.0 上的 4K@60Hz。 *适用于配备 4K/UHD/QHD 显示器 @60Hz 的笔记本电脑和 OEM 系统。* 如果您在启动时获得“gIOScreenLockState3”，则需要使用此属性。
-igfxbls	使 IVB+ 平台上的亮度过渡更加平滑
-igfxdbeo	修复 Ice Lake 平台内置屏幕显示乱码问题。
-igfxsklaskbl	强制在 SKL 上加载 Kaby Lake (KBL) 图形扩展程序。需要 KBL device-id 和 ig-platform-id。
applbkl=3	启用 AMD Radeon RX 5000 系列显卡的 PWM 背光控制

背光

applbkl=0	禁用 IGPU 的 AppleBacklight.kext 补丁
applbkl=3	启用 AMD Radeon RX 5000 系列显卡的 PWM 背光控制

诺特德雷德

-nreddbg	启用 kext 和 FB 的调试输出。
-nreddmlogger	启用 Display Core 调试输出
-nredoff	禁用 NootedRed
-nredfonly	仅在 FB 中启动，无加速。存在视觉伪影和故障。
-nred24位

苹果ALC

alcid=xx	为 AppleALC 设置布局 ID。 xx 代表编解码器的布局 ID。
-阿尔科夫	禁用 AppleALC
-alcdbg	启用调试打印。需要 AppleALC 的 DEBUG 版本
-alcbeta	在不受支持的 macOS 版本上启用 WhateverGreen（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
alcverbs=1	启用 alc-verb 支持。
alcdelay=xxx	在 AppleHDAController 中添加延迟。当 AppleHDAController 硬件未及时初始化而导致没有音频输出时很有用。 xx 代表延迟时间（以毫秒为单位）。不得超过 3000 毫秒。
alctcsel=1	修复从 Windows 重启后 macOS 上的音频问题。

AirPortBrcmFixup

-brcmfxdbg	启用调试打印。需要 AirPortBrcmFixup 的 DEBUG 版本
-brcmfxbeta	在不受支持的 macOS 版本上启用 AirPortBrcmFixup（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-brcmfxoff	禁用 AirPortBrcmFixup
-brcmfxwowl	启用 WOWL (WoWLAN) WOWL 默认禁用
-brcmfx-alldrv	允许修补所有支持的驱动程序，而不管当前系统版本
brcmfx-国家=XX	将国家代码更改为 XX（US、CN、#a、...）可以通过引导加载程序中的 DSDT 或 Properties → DeviceProperties 注入
brcmfx-aspm	覆盖用于 pci-aspm-default 的值
brcmfx-delay=xxxxx	将本机 Broadcom 驱动程序的启动延迟指定的毫秒数。它可以解决蒙特雷的死机或 Wi-Fi 设备丢失问题。您可以先将延迟设置为 15 秒（brcmfx-delay=15000），然后逐渐减少此值，直到启动时出现不稳定的情况。 xxxxx 代表延迟（以毫秒为单位）。
brcmfx 驱动程序=0\|1\|2\|3	仅启用一个 kext 进行加载 0 - AirPortBrcmNIC-MFG、 1 - AirPortBrcm4360、2 - AirPortBrcmNIC、 3 - AirPortBrcm4331，可通过 DSDT 或引导加载程序中的 Properties → DeviceProperties 注入

BrcmPatchRAM

启动参数	描述
bpr_initialdelay=x	变化`mInitialDelay`，其中`x`表示与设备进行任何通信之前的延迟（以毫秒为单位）。默认值为`100`。
bpr_握手=x	覆盖`mSupportsHandshake`，固件上传握手支持状态。 `0`意思是上传固件后等待`bpr_preresetdelay`ms，然后重置设备。 `1`表示等待设备的特定响应，然后重置设备。默认值取决于设备标识符。
bpr_preresetdeay	更改`mPreResetDelay`，其中 x 表示设备接受固件所需的延迟时间（以毫秒为单位）。当为时，该值未使用`bpr_handshake`（`1`手动传递或根据设备标识符自动应用）。默认值为`250`。
bpr_postresetdelay=x	更改`mPostResetDelay`，其中 x 表示固件上传后重置设备后固件初始化所需的延迟时间（以毫秒为单位）。默认值为`100`。
bpr_probedelay=x	更改 mProbeDelay（已在 BrcmPatchRAM3 中移除），即探测设备前的延迟时间（以毫秒为单位）。默认值为 0。
-btlfxallowanyaddr	在 macOS 12.4 及更新版本中禁用地址检查。由于 Apple 引入了新的地址检查`bluetoothd`，因此 macOS 12.4 及更新版本需要此功能，如果两个蓝牙设备具有相同的地址，则会触发错误。仅适用于 macOS 12.4 及更新版本。

伊特尔韦姆

启动参数	描述
itlwm_cc=国家代码	将国家代码更改为所需的国家代码，适用于所有设备，主要适用于使用 itlwm.kext 或运行早于 10.14 的 macOS 的 iwn、7000 和 8000 系列 iwm。
-novht	禁用 IEEE802.11AC 支持，如果路由器存在兼容性问题则很有用。
-noht40	使用 2.4GHz 时禁用 40MHz（如果此配置的网络导致不稳定，请使用此选项。Apple 原生支持的适配器默认禁用 2.4GHz HT40）

英特尔毛西

启动参数	描述
-mausiwol	为了测试目的，Froce 为英特尔以太网启用了 LAN 唤醒功能。对于错误配置的硬件是必需的。需要 IntelMausi.kext。

CPUTsc同步

启动参数	描述
-cputsdbg	启用调试日志记录。需要 CPUTscSync 的 DEBUG 版本。
-cputsoff	禁用 CPUTscSync。
-cputsbeta	在不受支持的 macOS 版本上启用 CPUTscSync（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-cputsclock	强制使用方法 clock_get_calendar_microtime 同步 TSC（`TSC_sync_margin`指定 boot-arg 时使用相同的方法）

CPU朋友

启动参数	描述
-cpufdbg	启用调试日志记录。需要 CPUFriend 的 DEBUG 版本。
-cpufoff	禁用 CPUFriend。
-cpufbeta	在不受支持的 macOS 版本上启用 CPUFriend（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。

CryptexFixup

启动参数	描述
-cryptdbg	启用详细日志记录。需要 CryptexFixup 的 DEBUG 版本。
-cryptoff	禁用 CryptexFixup
-cryptbeta	在不受支持的 macOS 版本上启用 CryptexFixup（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-crypt_allow_hash_validation	禁用 APFS.kext 修补
-crypt_force_avx	在 AVX2.0 系统上强制安装 Rosetta Cryptex

ECEnabler

启动参数	描述
-ecedbg	启用详细日志记录。需要 ECEnabler 的 DEBUG 版本。
-eceoff	禁用 ECEnabler
-ecebeta	在不受支持的 macOS 版本上启用 ECEnabler（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。

启动参数

描述

-ecedbg

启用详细日志记录。需要 ECEnabler 的 DEBUG 版本。

-eceoff

禁用 ECEnabler

-ecebeta

在不受支持的 macOS 版本上启用 ECEnabler（macOS 13 及以下版本默认启用）。

通常与新发布的 macOS 相关。

NVMeFix

启动参数	描述
-nvmefdbg	启用调试日志记录。需要 NVMeFix 的 DEBUG 版本。
-nvmefoff	禁用 NVMeFix。
-nvmefaspm	在所有设备上强制使用 ASPM L1。此参数仅建议用于测试目的，因为在日常使用中，可以将`pci-aspm-default`设备属性值注入到板载 SSD 设备及其连接的桥接设备中。更新后的值将在受影响的设备中`<02 00 00 00>`显示。`pci-aspm-custom`

功能解锁

启动参数	描述
-cardbg	启用详细日志记录。需要 FeatureUnlock 的 DEBUG 版本。
-carbeta	在不受支持的 macOS 版本上启用 FeatureUnlock（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-卡罗夫	禁用 FeatureUnlock
允许边车iPad	在未受支持的 iPad 上启用 SideCar 支持。
禁用sidecar_mac	禁用 SideCar/AirPlay/Universal Control 补丁。
禁用夜班	禁用 NightShift 补丁
-force_uni_control	即使模型不需要，也强制通用控制修补。

亮度键

启动参数	描述
-brkeysdbg	启用调试打印。需要 BrightnessKeys 的 DEBUG 版本。

MacHyperVSupport

核心控制器 (HyperVController)
核心 Hyper-V 控制器模块

启动参数	描述
-hvctrldbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

CPU 禁用程序 (HyperVCPU)
禁用 macOS 10.4 下的附加 CPU


-hvcpudbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

文件复制 (HyperVFileCopy)
提供主机到客户机的文件复制支持 (Guest Services)。需要hvfilecopyd用户空间守护进程处于运行状态。


-hvfcopydbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvfcopymsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvf复制	禁用该模块

图形桥（HyperVGraphicsBridge）
为 macOS 提供基本的图形支持。


-hvgfxbdgb	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvgfxbmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvgfxboff	禁用该模块

心跳（HyoerVHeartbeat）
向 Hyper-V 提供心跳报告。


-hvheartdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvheartmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvheartoff	禁用该模块

键盘（HyperVKeyboard）
提供键盘支持。


-hvkbddbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvkbdmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvkbdoff	禁用该模块

鼠标（HyperVMouse）
提供鼠标支持。


-hvkbddbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvkbdmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvmouseoff	禁用该模块

网络（HyperVNetwork）
提供网络支持。


-hvnetdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvnetdmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvnetoff	禁用该模块

PCI 桥 (HyperVPCIBridge)
提供 PCI 直通支持。


-hvpcibddbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvpcibmsgdbg	启用消息数据的调试打印。需要 MacHyperVSupport 的 DEBUG 版本
-hvpciboff	禁用该模块

PCI 模块设备 (HyperVmoduleDevice)
为 PCI 直通提供 MMIO 分配/释放功能。


-hvpcimdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

PCI 提供程序 (HyperVPCIProvider)
在第 2 代 VMS 上为伪 PCI 根桥 (HyperVPCIRoot) 提供 IOACPIPlatformDevice nub。


-hvkbddbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

PCI 根桥 (HyperVPCIRoot)
为第二代虚拟机上的正常 macOS 功能提供伪 PCI 根桥，并提供对 PCI 直通的支持。


-hvpcirddbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

关机 (HyperVShutdown)
通过虚拟机连接和 PowerShell 提供软件关机功能。需要hvshutdownd用户空间守护进程正在运行。


-hvshutdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvshutmsgdbg	启用消息数据的调试打印。需要 MacHyperSupport 的 DEBUG 版本
-hvshutoff	禁用该模块

存储（HyperVStorage）
提供 SCSI 存储支持。


-hvstordbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvstormsgdbg	启用消息数据的调试打印。需要 MacHyperSupport 的 DEBUG 版本
-hvstoroff	禁用该模块

时间同步 (HyperVTimeSync)
提供主机到客户机的时间同步支持。需要hvtimesyncd运行用户空间守护进程。


-hvtimedbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。
-hvtimemsgdbg	启用消息数据的调试打印。需要 MacHyperSupport 的 DEBUG 版本
-hvtimeoff	禁用该模块

VMBus 控制器 (HyperVVMBus)
提供 VMBus 设备和服务的根。


-hvvmbusdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

VMBus 设备节点 (HyperVVMBusDevice)
为子 VMBus 设备模块提供连接节点。


-hvvmbusdebdbg	启用调试打印。需要 MacHyperVSupport 的 DEBUG 版本。

Realtek读卡器

启动参数	描述
-iosd3v3	在 3.3V 下初始化所有卡，因此卡只能在默认模式或高速模式下工作。
-iosddsm	以默认速度模式初始化所有卡。最大数据传输速率限制为 12 MB/s。
-iosdhsm	以高速模式初始化所有卡。最大数据传输速率限制为 25 MB/s。
-iosdsabr	将每个 CMD18/25 请求分成多个 CMD17/24 请求，这样主机驱动程序就不会一次访问卡上的多个块。
-iosdnoacmd23	要求主机驱动程序在向卡发送 CMD25 之前不要发出 ACMD23。当驱动程序处理多块写入 (CMD25) 请求时，规范建议发出 ACMD23 来预擦除待写入的块，以提高写入性能。默认情况下，主机驱动程序始终在 CMD25 之前发送 ACMD23。如果您发现任何写入性能下降，请使用此启动参数。
约斯达姆纳	指定重试应用程序命令 (ACMD*) 的最大尝试次数。
rtsxdcib	如果驱动程序启动时卡已存在，请指定卡初始化的延迟时间（以毫秒为单位）。如果系统启动时无法初始化卡，请增加延迟时间。
rtsxdspi	指定轮询设备状态的间隔（以毫秒为单位）。后台线程会每隔 interval 毫秒检查卡片是否存在，并在卡片插入或移除时通知其他驱动程序组件。增加间隔会增加处理卡片事件的延迟，而减少间隔值则会浪费 CPU 周期，因此请谨慎选择间隔值。
-rtsxppsta	通过控制端点获取卡状态，而不是批量传输。某些 RTS5139 芯片只能通过控制端点报告卡状态，因此与默认机制不兼容。
rtsxdssc	指定等待 SSC 时钟稳定的时间（以毫秒为单位）。如果该值太小，驱动程序切换卡时钟后命令可能会超时。如果您在内核日志中发现驱动程序无法启用 4 位总线，请增加此值。

VoodooI2C

启动参数	描述
-vi2c-强制轮询	强制启用特定 I2C 控制器的轮询模式。当 APIC 中断不可用时需要。

RTCMemoryFixup

启动参数	描述
-rtcfxdbg	启用调试日志记录。需要 RTCMemoryFixup 的 DEBUG 版本。
rtcfx_exclude=偏移量1、偏移量2、起始偏移量-结束偏移量	不允许写入的偏移量或偏移量范围列表

休眠修复

启动参数	描述
-hbfxdbg	启用调试日志记录。需要 RTCMemoryFixup 的 DEBUG 版本。
-hbfxbeta	在不受支持的 macOS 版本上启用 FeatureUnlock（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-hbfxoff	禁用 kext 加载
-hbfx-转储-nvram	在休眠之前和内核崩溃之后将 NVRAM 保存到文件 nvram.plist（包含崩溃信息）
-hbfx-禁用-pci 补丁	禁用 IOPCIFamily 修补（此修补程序有助于避免恢复后挂起和黑屏（不会为所有设备调用 restoreMachineState）
hbfx-patch-pci=XHC、IMEI、IGPU	允许指定明确的设备列表（并且仅针对这些设备不会调用 restoreMachineState ）。还支持值 none、false、off。
hbfx-ahbm=abhm_value	控制自动休眠功能，其中 abhm_value 是以下各个值的算术和： EnableAutoHibernation = 1：如果设置了此标志，系统将进入休眠状态而不是常规睡眠（下面的标志可用于限制此行为） WhenLidIsClosed = 2：当盖子关闭时可以自动休眠（如果未设置位 - 无论盖子处于哪种状态） WhenExternalPowerIsDisconnected = 4：当外部电源断开时，可以自动休眠（如果未设置位 - 无论是否连接） WhenBatteryIsNotCharging = 8：当电池未充电时，可能会自动休眠（如果未设置位 - 无论是否正在充电） WhenBatteryIsAtWarnLevel = 16：当电池处于警告级别时，可能会发生自动休眠（macOS 和电池 kext 负责此级别） WhenBatteryAtCriticalLevel = 32：当电池电量处于临界水平时，可以自动休眠（macOS 和电池 kext 负责此水平） DoNotOverrideWakeUpTime = 64：不改变下次唤醒时间，macOS 完全负责睡眠维护暗唤醒 DisableStimulusDarkWakeActivityTickle = 128：在内核中禁用电源事件 kStimulusDarkWakeActivityTickle，因此该事件无法触发从暗唤醒到完全唤醒的切换

限制事件

启动参数	描述
-revdbg	启用详细日志记录。需要 RestrictEvents 的 DEBUG 版本。
-雷沃夫	禁用 RestrictEvents。
-revbeta	在不受支持的 macOS 版本上启用 RestrictEvents（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-revproc	启用详细进程日志记录。需要 RestrictEvents 的 DEBUG 版本。
revpatch=值	启用以逗号分隔选项的方式进行修补。默认值为自动。修补的可能值： memtab - 在 MacBookAir 和 MacBookPro10,x 平台的系统信息中启用内存选项卡 pci - 防止 MacPro7,1 平台上的系统设置中出现 PCI 配置警告 cpuname - 系统信息中的自定义 CPU 名称 diskread - 禁用 Finder 中的未初始化磁盘警告 asset - 当 sysctl kern.hv_vmm_present 在 macOS 11.3 或更高版本上返回 1 时允许内容缓存 sbvmm - 强制使用 VMM SB 模型，允许在 macOS 11.3 或更高版本上对不受支持的模型进行 OTA 更新 f16c - 通过在 macOS 13.3 或更高版本中禁用 f16c 指令集报告来解决 CoreGraphics 在 Ivy Bridge CPU 上崩溃的问题无 - 禁用所有修补自动 - 与 memtab、pci、cpuname 相同，但在真正的 Mac 上无需应用 memtab 和 pci 补丁
revcpu=值	启用或禁用 CPU 品牌字符串修补。 1 = 非英特尔默认，0 = 英特尔默认
revcpuname=值	自定义 CPU 品牌字符串（最多 48 个字符，建议不超过 20 个字符，否则从 CPUID 中获取）
revblock=值	将进程阻止为逗号分隔的选项。默认值为 auto 修补的可能值： pci - 阻止 MacPro7,1 平台上的 PCI 和 RAM 配置通知 gmux - 在 Big Sur+ 上阻止 displaypolicyd（适用于正版 MacBookPro9,1/10,1）媒体 - 在 Ventura+ 上阻止 mediaanalysisd（适用于 Metal 1 GPU）无 - 禁用所有阻止自动 - 与 PCI 相同

注意： 4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:revpatch、4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:revcpu和NVRAM 变量4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:revcpuname的4D1FDA02-38C7-4A6A-9CC6-4BCCA8B30102:revblock作用与启动参数相同，但优先级较低

。DebugEnhancer

启动参数	描述
-dbgenhdbg	启用调试输出。需要 DebugEnhancer 的 DEBUG 版本
-dbgenhbeta	在不受支持的 macOS 版本上启用 DebugEnhancer（macOS 13 及以下版本默认启用）。通常与新发布的 macOS 相关。
-dbgenhoff	禁用 DebugEnhancer。
-dbgenhiolog	将 IOLog 输出重定向到内核 vprintf（与 kdb_printf 和 kprintf 相同）