以下为黑苹果主板安装的详细教程，整合了主流主板设置、引导工具选择及常见问题解决方案，结合多个来源信息进行系统化梳理：
一、安装前的硬件准备与兼容性检查
1. 硬件兼容性要求
CPU：推荐Intel 8代至10代处理器（如i7-8700K、i9-10900K），AMD需使用特定补丁。
显卡：AMD RX 500/600系列（如RX 560/6600XT）免驱优先；NVIDIA显卡仅支持旧版macOS（需Web Driver）。
主板：优先选择技嘉、华硕等支持UEFI的主板，确保BIOS可关闭安全启动和CFG Lock。
存储：建议使用GPT分区格式的SSD，预留200MB以上EFI分区。
2. 工具与镜像准备
引导工具：推荐OpenCore（OC）或Clover（新手可选Clover）。
系统镜像：优先使用原版镜像（如黑果小兵制作的.dmg文件），避免懒人版稳定性问题。
必备软件：
BalenaEtcher（镜像写入工具）。
OpenCore Configurator（OC配置文件编辑）。
Kext驱动包（Lilu、WhateverGreen、VirtualSMC等）。
二、主板BIOS关键设置详解
不同品牌主板需调整以下核心选项（以华硕/技嘉为例）：
1. 必改选项
Secure Boot → Disabled
Fast Boot → Disabled
CSM → Disabled（确保纯UEFI模式）
SATA Mode → AHCI（禁用RAID）
CFG Lock → Disabled（若无选项需通过OC补丁解锁）
2. CPU与电源管理
Intel VT-d/AMD SVM → Disabled
Above 4G Decoding → Enabled（解决PCIe设备识别）
XMP/DOCP → Enabled（确保内存频率正常）
3. 显卡与核显设置
Primary Display → PCIe/iGPU（根据显卡类型选择）
DVMT Pre-Allocated → 64MB/128MB（核显必备）
Re-Size BAR Support → Disabled（避免与OC冲突）
4. USB与外围设备
XHCI/EHCI Hand-off → Enabled
Legacy USB Support → Disabled
三、OpenCore引导配置与驱动安装
1. EFI结构搭建
使用工具（如SSDTTime）提取DSDT并生成SSDT补丁。
将驱动文件（.kext）放入`EFI/OC/Kexts`目录，核心驱动包括：
Lilu.kext（驱动基础依赖）
WhateverGreen.kext（显卡驱动）
VirtualSMC.kext（模拟白苹果SMC）。
2. config.plist配置
使用ProperTree编辑配置文件，重点调整：
ACPI：加载SSDT补丁（如SSDT-PLUG、SSDT-EC）。
Kernel：注入必要驱动并设置启动参数（如`-v`调试模式）。
PlatformInfo：生成合法三码（使用GenSMBIOS工具）。
四、系统安装与调试
1. 启动盘制作
使用BalenaEtcher将镜像写入U盘，格式化为APFS或HFS+。
将EFI文件夹复制到U盘的ESP分区。
2. 安装过程
插入U盘并选择UEFI启动项，进入macOS安装界面。
使用磁盘工具格式化目标硬盘为APFS，执行系统安装。
3. 安装后优化
驱动补全：通过OpenCore Configurator挂载EFI分区，添加缺失驱动（如声卡/网卡）。
电源管理：加载SSDT-PLUG补丁优化CPU性能。
睡眠唤醒修复：检查USB定制和XHCI设置。
五、常见问题与解决方案
1. 启动失败（卡代码）
使用`-v`模式查看错误日志，常见原因：
ACPI错误 → 检查SSDT补丁。
显卡驱动问题 → 添加`agdpmod=pikera`参数（AMD显卡）。
2. 显卡黑屏/花屏
核显用户需确认DVMT显存分配≥64MB，独显用户检查PCIe插槽供电。
3. 无法识别硬盘
BIOS中确认SATA模式为AHCI，禁用Intel RST。
六、推荐资源与工具
1. 教程参考：
国光的黑苹果安装教程（GitHub开源项目）。
OpenCore官方指南（Dortania维护）。
2. 驱动与工具下载：
GitHub：搜索对应机型的EFI配置文件。
黑果小兵部落阁：获取稳定镜像与驱动包。
注意事项：
安装前务必备份数据，避免使用非官方镜像导致系统不稳定。
主板BIOS版本建议升级至最新，部分功能需特定版本支持。
若多次尝试失败，可参考社区案例（如远景论坛、Reddit/r/hackintosh）调整配置。
