引导参数
⚙️

引导参数

标签
黑苹果
创建时间
Jan 17, 2022 04:26 PM
上次编辑时间
Last updated February 13, 2023
参数
说明
-v
啰嗦模式,用于安装前期启动时显示代码界面,在安装macOS时,应添加此参数以获取明确的错误信息。
-x
安全启动模式,类似 Windows 的安全模式。此模式下 macOS 会尽可能少的加载 Kext 文件。
-s
单用户模式。这一模式将会启动终端模式,可以用这种方式修复你的系统。
-f
关闭 Kext 缓存模式,等于强制重建 Kext 缓存。
-l
在系统日志中输出内存泄漏的相关记录。
arch=x86_64
该参数会强制 macOS 以 64 位内核模式启动,在 10.15 及以上没有什么作用。对应的是 arch=i386,将强制以 32 位模式启动。
slide=#
用于引导系统时分配系统内核在内存中的位置,Clover 在一排加号处卡住可以尝试 slide=0,其它参考:Slide 值的说明
iog=0x0
此参数将强制 MacBook 机型在合盖后,接入外部显示器和键盘时系统保持开启状态;但同时,此参数会在接入外部显示器时关闭笔记本的内屏,这可能对保护屏幕以及省电有帮助。
idlehalt=1
强制 CPU 进入低功耗模式。
nvda_drv=1
用于启用英伟达显卡驱动,包括开启 NVIDIA Web Driver
nv_disable=1
关闭英伟达显卡驱动,请勿与 nvda_drv=1 同时使用。
npci=0x2000
此参数会禁用某些与 kIOPCIConfiguratorPFM64 相关的 PCI 调试,另一个相似的选择是 npci=0x3000,后者还会禁用与 gIOPCITunnelledKey 相关的调试。当卡在 PCI Start Configuration 时,应使用此参数,因为存在与 PCI 通道有关的 IRQ 冲突。
npci=0x3000
同 npci=0x2000。
no_compat_check
关闭兼容性检查。例如,macOS 11.0 BigSur 不再支持 iMac 2014 年之前推出的机型,此时可使用此参数以禁止兼容性检查,以达到安装目的。
kext-dev-mode=1
启用 Kext 开发模式, 非开发者请勿使用。在 10.11 及以后的系统中,已无需此参数。
debug=0x100
此参数用于禁用五国图,把 Kernel Panic(内核崩溃)的相关数据直接输出在屏幕上,可用于禁止发生内核崩溃时自动重启,这将对排查错误有助益,这一参数还可以用于 Core Dump。其它可用值还有:0x200,这可以在内核崩溃后使用快捷键(C 继续、R 重启、K 进入 KDB);0x400 可用于触发内核崩溃后自动进行 Core Dump;0x2000 将只生成并发送 Kernel Panic 日志,不包括完整的 Core Dump。除此之外还有很多其他值,但一般以上几个已经足够安装 macOS 时使用。
keepsyms=1
此参数可以为 debug=0xN 提供更多错误信息。
dart=0
禁用 VT-d,此参数会关闭 64 位硬件上的系统 PCI 地址映射器(DART)。DART 在拥有 2GB 以上物理内存的机器上是必需的,在默认情况下 DART 都是加载的。当使用 Clover 引导系统且 BIOS 无法关闭 VT-d 时可尝试此参数。
darkwake=0
禁用 Power Nap
cpus=#
启用 # 个 CPU 核心。苹果的开发者工具有一个选项用于启用或禁用系统中的一些 CPU,但你也可以通过这个参数指定要使用的 CPU 数量。在某些情况下,这也许有助于省电,或者你正在调试 X86 电源驱动。
amd_no_dgpu_accel
关闭 AMD 显卡硬件加速
gux_no_idle
用于终止英特尔芯片的空闲模式(idle-mode)功能。

建议的参数

全新安装 macOS 10.15 及以上时,在没有特殊情况下,最基础常用的参数有下面几个:
  • v:跑码排错
  • debug=0x100 或 debug=0x200:防止自动重启,禁用五国图直接输出错误信息
  • keepsyms=1:辅助上一个参数
  • agdpmod=pikera:Navi 核心避免黑屏使用,其它显卡如 RX400/500,Vega56/64 无需此参数
  • npci=0x2000 或 npci=0x3000:AMD 系统没有开启 Above 4G Decoding 时使用;X299 卡在 PCI Start Configuration 时使用
若要使用其它参数,根据上面的解释按需添加即可。