黑苹果启动盘制作：gh_mirrors/ha/Hackintosh项目U盘安装教程

准备工作

制作黑苹果启动盘前，需准备以下资源和工具：

• 核心文档：README.md（项目基础说明）
• 工具集：Tools/（包含启动盘制作所需的各类实用工具）
• 硬件要求：16GB及以上容量U盘（建议USB 3.0接口）
• 系统环境：已安装macOS的电脑（推荐10.15 Catalina及以上版本）

工具获取与准备

项目克隆

通过以下命令克隆项目仓库，获取完整工具集：

git clone https://gitcode.com/gh_mirrors/ha/Hackintosh
cd Hackintosh

必备工具清单

项目提供的工具目录包含制作启动盘所需的核心组件：

工具路径	功能说明
Tools/mount_efi.sh	EFI分区挂载脚本
Tools/WebDD.command	驱动自动下载工具
Tools/BDMESSG	启动日志分析工具
Tools/gfxutil	显卡设备路径获取工具

U盘格式化

磁盘工具操作步骤

1. 插入U盘，打开「磁盘工具」
2. 选择U盘，点击「抹掉」
3. 配置格式参数：
   • 名称：Hackintosh
   • 格式：Mac OS 扩展（日志式）
   • 方案：GUID分区图

终端命令格式化

若偏好命令行操作，可使用以下命令：

diskutil eraseDisk JHFS+ Hackintosh GPT /dev/disk2
# 注意：将/dev/disk2替换为实际U盘设备路径

系统镜像写入

创建可启动安装介质

使用createinstallmedia工具写入官方macOS镜像：

sudo /Applications/Install\ macOS\ Big\ Sur.app/Contents/Resources/createinstallmedia --volume /Volumes/Hackintosh

验证写入结果

执行以下命令检查U盘是否可引导：

diskutil list /Volumes/Hackintosh

成功的输出应包含EFI分区和macOS Installer标签。

EFI配置部署

挂载EFI分区

运行项目提供的EFI挂载脚本：

sh Tools/mount_efi.sh

脚本会自动识别U盘的EFI分区并挂载到/Volumes/EFI路径。

EFI文件复制

将项目中的EFI文件夹复制到U盘EFI分区：

cp -R EFI /Volumes/EFI/

驱动配置

使用WebDriver下载工具获取适配驱动：

open Tools/WebDD.command

驱动下载界面如图所示：

选择与目标系统版本匹配的驱动，下载后放入EFI/OC/Drivers目录。

启动参数配置

config.plist调整

使用ProperTree编辑EFI分区中的config.plist：

1. 配置SMBIOS信息（可通过Tools/sn.sh生成）
2. 启用必要的启动参数：-v keepsyms=1 debug=0x100
3. 根据硬件配置调整ACPI补丁

CFG-Lock解锁

若主板支持，使用以下工具解锁CFG-Lock：

• Tools/CFGLOCK/CFGLock.efi
• Tools/CFGLOCK/VerifyMsrE2.efi

启动测试与故障排除

启动日志查看

使用bdmesg工具分析启动过程：

Tools/bdmesg > boot.log

常见问题解决

USB端口问题

运行USB端口映射工具生成适配配置：

sh Tools/usb_Ports

显卡驱动问题

使用gfxutil获取显卡设备路径：

Tools/gfxutil -f display

将输出结果填入config.plist中的DeviceProperties部分。

系统安装后续配置

系统信息检查

安装完成后，使用archey工具验证系统信息：

sh Tools/archey

系统信息展示效果：

驱动更新维护

定期运行以下命令更新驱动：

sh Tools/WebDD.command --update

总结

通过本教程，你已掌握使用gh_mirrors/ha/Hackintosh项目制作黑苹果启动盘的完整流程。关键步骤包括：工具准备、U盘格式化、系统写入、EFI配置和故障排除。项目持续更新支持新机型，最新维护记录可查看Changelog.md。

建议收藏本教程，关注项目更新，以获取最新的兼容性信息和工具优化。如有问题，可参考项目文档或加入黑苹果社区讨论。