# 安装过程中的疑难解答 ## 这个页面解决什么问题？ 解决你在安装 macOS 的过程中可能遇到的各种问题，包括：无法正常安装系统/安装完系统后 panic/无法正常使用...等，直到让你能看到 macOS 的桌面，进行下一步操作为止。 ## 我需要拥有什么工具/掌握什么前置知识？ 首先你需要对 Hackintosh(黑苹果) 的引导程序——Clover 有所了解。让我们回顾一下这些名词： * 啰嗦模式（verbose mode, -v） * 安全模式（safe mode, -x） * 内核拓展（kext） * Clover UEFI 驱动 (UEFI Drivers) 什么？你对这些名词一头雾水？建议你先阅读 [《Clover 使用教程》](https://blog.daliansky.net/clover-user-manual.html) 然后再进行下一步操作。 部分操作要求你的电脑需要有一个正常工作的 Windows 系统。如果有条件的话，你可以制作一个 Windows PE 启动盘备用。 ## 首先请确认以下几点…… 1. 请确保你阅读了正确的教程，下载了常见的安装镜像。本仓库的配置文件，只在“黑果小兵集成镜像” 和 “Len's DMG” 下测试通过，我们推荐使用这两种镜像安装系统。其他私人制作的镜像或第三方组织的镜像以及非正常途径安装的系统（如：X 苹果乐园的镜像，某宝安装的恢复版系统）均不在本仓库配置文件的技术支持考虑之内。 2. 请确认你的机器没有安装三星 PM981 或 PM981a 固态硬盘。若你有 Samsung 970Evo Plus 固态硬盘，请先将其升级到最新固件，否则无法兼容 macOS. 部分三星固态硬盘（常见 SM961, PM983 等）、Intel 固态硬盘（常见 600p, 660p, 部分 760p）也可能在安装和使用的过程中出现问题。如果你的机器安装了上述固态硬盘并出现了奇怪的问题，请首先拔掉硬盘排除故障。请尽可能使用 APFS 分区格式安装系统以避免部分兼容性问题。 {% hint style="success" %} Tips：联想版 PM981 （序列号结尾为 000LX）512G 及以上容量可以通过更新到联想官方提供的最新固件，来解决黑苹果的支持问题。对于零售版本（序列号结尾为 00000）的 PM981 暂时没有解决方案。 {% endhint %} ## 常见问题 ### BIOS 进入 Clover 引导时提示 "Invalid Signature..." 出现此问题的原因是你没有在 BIOS 中关闭安全启动 (Secure Boot). 你需要在开机时按 F2 进入 BIOS， 在 Advanced 选项卡中，关闭 Secure Boot （设置该项为 disabled），按 F4 并选择 Yes 保存退出。 ### Clover 引导程序中检测不到 macOS 启动项或任何 HFS/APFS 分区 出现此问题的原因可能是： 1. 你的 Clover 版本不正确，你替换了配置文件，但并没有替换完全 2. 你的分区确实没了 对于第一种情况，请检查一下 Clover 版本，可以在 Clover 的右下角看到四位数的数字。对于本仓库的配置文件，这个数字需要大于 5000（默认仓库下带的 Clover 版本是 50xx）。 如果这个数字小于 5000，请重新替换引导设备 ESP 分区下的 EFI/CLOVER/CLOVERX64.efi 文件。**如果你使用 U 盘引导系统, 那么你还需要将这个文件复制到 EFI/Boot 下，并更名为 bootx64.efi**. ### 安装系统时无法正常使用 Clover 引导安装程序（无法选择引导项等） 请确认你使用了上文推荐的镜像。当下我们不推荐安装任何 10.13 的版本。 如果你安装的是黑果小兵的 10.13 版本，请自行替换 Clover 版本并加入 USBInjectAll.kext；如果你安装的是 10.14 版本，请尝试在写入 U 盘后替换 U 盘 ESP 分区中的 CLOVERX64.efi。 ### 使用 Clover 引导系统时，提示 "Error allocating runtime area 0x..." 删除 /EFI/CLOVER/drivers/UEFI (或 /EFI/CLOVER/driver64UEFI) 下的 AptioMemoryFix.efi；使用 [**OsxAptioFix2Drv-free2000.efi**](https://github.com/kirainmoe/hasee-tongfang-macos/raw/master/drivers/Alternative%20UEFI%20Driver/OsxAptioFix2Drv-free2000.efi) 替换上述文件，并且在 config.plist 中添加引导参数 slide=0 即可。 ### 常见：安装时出现禁行标志，-v 日志卡在 still waiting for root device ![still waiting for root device](https://camo.githubusercontent.com/3ed7abdf74644189ba0bc725bd1b4ca614ec6946/68747470733a2f2f626273696d672e6a6f79736c696e6b2e636f6d2f323031382f30312f31382f31343235343333325f696d6167653135313632373234303738303238362e6a7067) 第一步，首先检查你的 BIOS 设置中是否将磁盘模式设置成了 AHCI（可以在 BIOS 的 Advanced 界面中找到），macOS 并不支持 RAID 模式。（调节该设置可能需要你修复或重新安装 Windows，这里不再赘述）。 第二步，检查 USB 问题。请将安装 U 盘插在你的机器的 USB 2.0 口上。例如对于 GZ 系列机型，请将安装 U 盘插在机器左侧的 USB 口；如果你安装的是 10.13 版本，需要自行加入 `USBInjectAll.kext`. 如果你的电脑没有 USB 2.0 接口，请将 U 盘插在你电脑的每一个 USB 接口都试一次。 ### 安装时卡在 "PCI Configuration end" 此问题可能在使用黑果小兵的 10.15 镜像安装系统时出现。 请下载 [config-10.15-installer.plist 。](https://www.lanzous.com/i6prmlg)在 Windows 下使用 DiskGenius （或其它 mac 设备上）挂载安装 U 盘的 EFI 分区，然后用下载得到的 config-10.15-installer.plist 文件，替换 EFI/CLOVER 目录下的 config.plist. {% hint style="success" %} Tips: 对于 hasee-tongfang-macos 仓库支持的机型，也可以直接下载最新版配置文件，替换 EFI 后再安装系统。 {% endhint %} ### 常见：抹盘时提示“MediaKit报告设备上的空间不足以执行请求的操作” 出现该问题的原因是你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB。 如果没有 ESP 分区，那么到 PE/Windows 下删除 macOS 分区，分出 200M 以上的 ESP/FAT16/FAT32 分区即可。 后者的解决方案是制作 Windows PE 启动盘，到 PE 下删除安装磁盘的 MSR 分区并将 ESP 分区扩容到 200MB 以上，或删除 ESP 分区，在磁盘末尾划分出 200M 以上的空间创建一个新的 ESP/FAT16/FAT32 并重建引导，操作 2 要求用户对重建引导和分区等操作较为熟悉。 这一步请谨慎操作，稍有不慎轻则导致 Windows 引导丢失，严重则导致分区数据丢失！ ### 安装时卡在 `apfs_module_start` 或 `VoodooPS2Controller` 等 该问题在新的同方模具机型上出现。 首先删除 VoodooPS2Controller.kext， 使用 AppleACPIPS2Nub.kext 和 ApplePS2Controller.kext 替换它。你可以在 9 代同方机型的分支下的 kexts/Others 中找到这两个 kext. 接下来，请使用 Clover Configurator 在Acpi - DSDT - Patches中添加以下补丁。你可以在另一台已经安装好 macOS 的电脑下，用 Clover Configurator 操作。 ``` Comment: RTC: fix 9th tongfang model RTC bug Find: A00A9353 54415301 Replace: A00A910A FF0BFFFF ``` 如下图所示： ![](https://camo.githubusercontent.com/fcff5d9d7e501bfcca3c7e4bb5451c418595b815/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30362f31322f3564303065353032303937366237393031332e706e67) 如果你没有已安装好 macOS 的电脑，也可以修改 config.plist，在 ACPI 的 Patches 下添加以下内容： ``` Comment RTC: fix _STA method bug for 9th gen Tongfang models Disabled Find oAqTU1RBUwE= Replace oAqRCv8L//8= ``` 如下图： ![](https://camo.githubusercontent.com/0bbd64cdfc7c61f21411538d3c92810bd245790a/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30362f31322f3564303065353032376432363736333339322e706e67) {% hint style="success" %} Tips: 你也可以直接替换配置文件后再进入安装程序。 {% endhint %} ### 安装时键盘无法使用 该问题在 9 代同方机型上出现。出现问题的原因是 VoodooPS2Controller 驱动不兼容同方新九代机型，你必须使用 `ApplePS2Controller.kext + AppleACPIPS2Nub.kext` 代换 `VoodooPS2Controller.kext`（你可以在 CT7GK 的配置文件中找到），或者可以直接替换配置文件后安装。 ### 非 9 代机型安装 10.15 卡在 apfs\_module\_start 或 PS2Controller 请替换配置文件后安装，或使用另一台 macOS 运行 Clover Configurator, 在 config.plist 的 ACPI 重命名中，中添加如下补丁： ``` Comment Find*[HEX] Replace[HEX] change EC0 to EC 4543305f 45435f5f change H_EC to EC 485f4543 45435f5f change ECDV to EC 45434456 45435f5f ``` ### 抹盘时磁盘工具自动退出 你的 macOS 安装盘没有 ESP 分区或该分区大小不足 200MB，而你选择的分区格式为 MacOS 扩展。请参考上一条解决 ESP 问题，并使用 APFS 格式抹盘安装系统。 ### 安装选择磁盘时提示磁盘未挂载 你必须正确抹盘为 APFS 格式（磁盘工具提示成功，没有任何错误提示、没有闪退）才可以安装。如果出现未挂载且磁盘工具无法挂载，你必须到 Windows 或 PE 下删除 macOS 的分区，重新分区和抹盘。 ### 安装选择磁盘时提示不是 GUID 分区格式 你的安装硬盘必须是 GUID 格式的分区表（俗称 GPT）才可以安装 macOS. 如果你的安装目标硬盘没有其它操作系统，那么直接使用 DiskGenius 专业版的“转换硬盘为 GPT 分区表”功能转换，并按照上文说明创建 ESP 分区即可。 如果你的安装目标硬盘有 Windows 系统，除了上述转换和创建 ESP 操作之外，你还需要到 Windows PE 下重建 Windows 的引导，并在 BIOS 中开启 UEFI 引导模式。这里不赘述这两项操作，请自行将上述内容复制到百度里搜索相应的教程。 ### 安装时提示“这个安装 macOS 应用程序副本已损坏” 首先在断开网络的情况下开机。 进入安装程序前，打开终端， 输入： ```bash date 1025102016.20 ``` 回车，再进入安装程序即可。 ### 安装卡在第一次走条的最后两分钟很久，而后提示“安装器资源损坏” 1. 首先断开网络，确保你下载的是当前最新版本的镜像；验证你下载镜像的 MD5 是否正确； 2. 如果 MD5 正确，尝试更换 U 盘或重新写入安装盘； 3. 如果上述两步无效，那么尝试使用 `OsxAptioFixDrv-64.efi` 或者 `OsxAptioFixDrv3-64.efi` 替换 `drivers/UEFI/AptioMemoryFix.efi`，每次只可以用一个驱动。 > Tips：你可以在 `drivers/Alternative UEFI Driver` 下找到这两个驱动。 如果上述操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘。 {% hint style="info" %} 如果你仅仅是卡在最后两分钟很久，而没有任何提示，不妨重启看看 Clover 是不是多出了一个启动项。 {% endhint %} ### 安装时提示“安装器资源已过期” 1. 确认你的 BIOS 时间正确，在安装时断开网络； 2. 在 Clover 引导界面按一下 F11 清空 NVRAM，重新尝试安装； 3. 下载最新版的镜像安装。 ### 安装时提示“找不到安装器资源” 1. 断开网络，确保你下载的是当前最新版本的镜像，验证你下载镜像的 MD5 是否正确； 2. 如果 MD5 正确，尝试删除 CLOVER 文件夹下的 `drivers/UEFI/EmuVariableUefi-64.efi`； 3. 如果第二步操作仍然无效，那么请修改镜像自带 CLOVER 配置的 SMBIOS 为 `MacbookPro15,1`，在 Clover 的界面按 O ，定位到 SMBIOS 页面即可修改； 4. 如果第三步操作仍然无效，请检查你是否使用三星或 Intel 固态硬盘； 5. 如果你没有使用且你的机器是双硬盘，请在安装时拔掉不是安装位置的那个硬盘，安装完后再插回去。 ### 常见：安装完成后重启发生内核 panic，卡在 `VTDecoderXPCService` 错误 ![Cache\_4d3cf18912973f8e..jpg](https://camo.githubusercontent.com/49be36a2839c4873ca260f65178ec39c86489768/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31382f334861794e513576694a526c3136472e6a7067) 请在 Clover 界面按 O，定位到显卡设置（带有 Graphics 字样），勾选 `Inject Intel`，并修改 `*-platform-id` 从 `0x12345678` 修改为 `0x3E9B0000`。 ### 安装完成后重启发生内核 panic，列出一堆 kext 并提示“Please go to [http://panic.apple.com](http://panic.apple.com/) ”. ![B32B2C53-C17D-4233-977B-9DE596750EBA.jpeg](https://camo.githubusercontent.com/50a4cfd9875da028b0adc628ef129ebb53d491c6/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32322f5648417651684c3659784b623758732e6a7067) 出现此问题是由于发生了内核 panic，但 Lilu.kext 输出了调试信息，无法确定故障。 如果出现这种情况，请在 Clover 界面按 O，在引导参数中添加 `-x -liluoff`（注意和已有的参数用空格隔开），引导系统查看是否解决。如果没有解决请到群中求助。 ## 最后 如果上面的内容解决了你的问题，使你成功地安装了系统，那么恭喜你可以开始进行下一步操作了。 如果你遇到了其它问题，请提 issue 联系我。