> For the complete documentation index, see [llms.txt](https://hackintosh.kirainmoe.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hackintosh.kirainmoe.com/an-zhuang-zhong/macos-an-zhuang-jian-ming-jiao-cheng.md).

# macOS 安装简明教程

{% hint style="warning" %}
提示：本页面的教程可能已经过时，仅供参考。最新安装方式请参考以下视频教程：<https://www.bilibili.com/video/av81263778>
{% endhint %}

## 这个页面解决什么问题？

这篇文章将引导你在已有 Windows 操作系统的环境下，全新安装 macOS 到你的笔记本上。

## 适用于哪些机型？

本仓库支持的所有机型，都可以按照这篇教程来安装。当然，鉴于在任何机器上，黑苹果的安装流程大体是一样的，因此本仓库支持外的其他机型也可以参考。

## 我需要掌握什么前置知识？

理论上，只要读者具有使用搜索引擎查找问题的能力，以及足够细心和耐心，照着教程一字一句地看，一步步地做，那么读者不需要任何前置知识。

当然，最基本的电脑维护操作，如重装 Windows 系统，分区，更改 BIOS 设置等，至少读者是要会的。

此外，因为黑苹果安装过程中涉及大量的英文信息和选项，可能要求读者具有一定的英语阅读理解水平。

## 其他参考资料

如果你看下面的内容很吃力，你也可以参考下面的文章 & 视频，多看几篇教程总是好事。

《联想小新Air 13安装黑苹果兼macOS Mojave安装教程》：<https://blog.daliansky.net/Lenovo-Xiaoxin-Air-13-macOS-Mojave-installation-tutorial.html>

《苏逸爱科技 黑苹果视频教程》：<https://www.bilibili.com/video/av58097219>

## 我需要准备什么？

安装 macOS 最基本要求是这样的：

* 一台准备安装 macOS 的电脑，有至少 30GB 的可用硬盘空间
* 一个 8GB 或以上的 U 盘和一个 USB 鼠标
* 做好重要数据的备份

你需要下载的东西有：

* **macOS 最新版本的安装镜像**
* [balenaEtecher](https://www.balena.io/etcher/) 或 TransMac 用于写入镜像
* [DiskGenius 硬盘分区维护工具](http://www.diskgenius.cn/)
* [Hasleo EasyUEFI](http://www.smzy.com/smzy/down416541.html) 或 bootice

关于安装镜像，我们推荐下载 [黑果小兵的集成镜像](https://blog.daliansky.net/categories/%E4%B8%8B%E8%BD%BD/%E9%95%9C%E5%83%8F/) 或 Len's DMG （可以到远景论坛下载）的最新版本。

如果你对基本的重装系统、修复引导等功能一窍不通，有条件的话你还可以另找一个 U 盘，制作一个 Windows PE 环境，以便在误操作导致 Windows 无法进入时，进行修复。建议使用 [wepe](http://wepe.com.cn/) 或 [ConcisePE](https://www.appcgn.com/concisepe.html).

## 确认几件事情……

* 确认你下载的镜像文件是完整的。默认在镜像下载的站点会给出当前镜像的 MD5 哈希值，你可以使用 MD5 校验工具来检查你下载的镜像的哈希值与作者给出的是否一致。
* 确保你准备安装 macOS 的目标硬盘为 GUID 格式（俗称 GPT 格式）：[查看教程](https://jingyan.baidu.com/article/ad310e80a9298a1849f49e17.html)。如果不是 GPT 分区表，你需要将该硬盘先转成 GPT 格式：[查看教程](https://www.jianshu.com/p/8e7cae1dcb64).
* 确保你的电脑里**没有安装三星 PM981 / PM981a** NVMe 固态硬盘，原因是三星这两款型号的固态硬盘不兼容 macOS，会引起死机和无法正常安装系统问题。**如果你的电脑安装了三星 970 Evo (Plus) 固态硬盘，请先将 SSD 的固件更新到最新版本。**&#x90E8;分其他三星硬盘和 Intel 硬盘也会在安装和使用过程中出现问题，建议在购买 NVMe 固态硬盘时避免购买这两个品牌。
* 确保你的目标安装硬盘有一个大于 200MB 的 ESP 分区。你可以使用 DiskGenius 查看目标硬盘 ESP 分区的大小，如果不足 200M，请参照[这篇文章](/an-zhuang-zhong/tiao-zheng-esp-fen-qu-he-zhong-jian-windows-yin-dao.md)将目标硬盘的 ESP 分区调整到 200M 以上。

{% hint style="warning" %}
Tips: 三星 PM981 / PM981a 固态硬盘的型号通常以 MZVLB 开头，如 MZVLB256HAHQ-00000（零售版 PM981，容量为 256G）。注意其他序列号开头的三星固态硬盘不一定可用，但以 MZVLB 开头的固态硬盘一定不可用。
{% endhint %}

## 准备就绪！

让我们首先来浏览一遍简明版的安装的流程，以便你时刻知道自己走到了哪一步，该干什么：

1. 使用 balenaEtecher 将安装镜像写入 U 盘
2. 使用 Windows 自带磁盘工具划分安装 macOS 的硬盘空间并分区
3. 重启电脑调整 BIOS 设置
4. 从 U 盘引导 Clover 安装程序
5. 在 macOS 安装助理中使用磁盘工具抹掉待安装的分区
6. 开始安装系统（分为从 U 盘拷贝文件的第一阶段，和从硬盘展开文件的第二阶段）
7. 首次进入系统的用户设置
8. 后续工作（包括替换 EFI，优化等）

如果你是有经验的电脑玩家，那么你可以不需要借助下面的文章，直接根据上面的简明摘要，开始安装 macOS 了。

## 写入安装镜像

备份好 U 盘数据，拔除所有已插入的移动存储设备，插入准备写入安装镜像的 U 盘，并打开 balenaEtecher。

首先点击 `Select Image` 选择你下载好的 macOS 安装镜像（通常是后缀为 `dmg` 的文件）；

然后，确认正中间的设备名称与你用于安装 macOS 的 U 盘对应。如果不对应，那么可以点击 `change` 改变设备。

确认好后点击 `Flash!`，程序会开始自动向 U 盘写入安装镜像，耐心等待直到完成，如果程序未响应请不要动它和强制退出。

如图所示（图源网络）：

>

![etecher](https://github.com/daliansky/XiaoMi-Pro/raw/master/wiki/img/Installation_2.JPG)

如果写入镜像的过程一切正常，etecher 会提示成功，并且 Windows 会弹窗提示“新分区需要格式化后才能使用“（此时只是 Windows 无法识别 HFS+ 格式的安装镜像分区，**千万不要点击格式化！**）。如果 etecher 提示写入失败，那么你需要检查一下安装镜像的完整性和 U 盘的质量问题。

## 划分磁盘空间并分区

如果你当前的磁盘有空闲空间，那么直接将空闲空间格式化为 NTFS 格式，并取一个你容易区分的名字，如 `macOS PreInstall`.

如果你当前的磁盘没有空闲空间，那么你需要压缩已有的分区，划分一部分空闲空间出来后，再创建分区。压缩分区的具体操作为：右键“此电脑（计算机/这台电脑...）“，依次点击”管理“ => “磁盘工具”，右键选择你要压缩空间的分区，点击“压缩卷”，调整压缩后的分区大小。然后将空闲空间按照上文指导建立新分区即可。

{% hint style="success" %}
Tips: 如果你要压缩的是 Windows 系统盘的空间，那么你可能需要在 Windows PE 环境下操作。
{% endhint %}

再次确认你的目标安装硬盘具有 200M 以上的 ESP 分区，然后继续下一步。

## 重启电脑并调整 BIOS 设置

重启电脑并进入 BIOS （不同机型进入 BIOS 的按键不同，如神舟同方模具笔记本可按 `F2` 键进入 BIOS），主要调整如下设置：

* 转到 `Advanced` 选项卡，并将 `OS Support` 修改为 `UEFI OS`, `SATA mode detection` 设置为 `AHCI`（如果有）

![QQ20190920-173341.png](https://camo.githubusercontent.com/a6ebb076c6925891a6ce0dff210fd868924bd494/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6c314d4854747356385a39787675432e706e67)

* 转到 `Security` 选项卡，并将 `Secure Boot` 选项设置为 `Disable`（禁用安全启动）

![QQ20190920-173452.png](https://camo.githubusercontent.com/b89fe44f07dc61a9b80e85237e68b03c0d8ccfe0/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f675042334c627a416e4775493734742e706e67)

* 转到 `Boot` 选项卡，设置 `Launch CSM` 为 `Disabled`.

![QQ20190920-173507.png](https://camo.githubusercontent.com/dcf6f97c8017642bf066fa4f44382b805393753c/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f64384148585637717a4f54746932332e706e67)

然后按 `F4` 保存退出（根据机型不同，保存按键也会不同），重启即可。

## 从 U 盘引导 Clover 安装程序

将 U 盘插到电脑上的 **USB2.0 接口**，在开机时按快捷键进入引导选择菜单（根据机型的不同按键可能会不同，如神舟同方机型的快捷键为按住 `F7`），然后选择你的 U 盘（通常他会在第一位，以 `UEFI: XXXXX` 的形式出现），回车引导 Clover.

然后使用方向键定位到文字说明为 `Boot macOS Install from Install macOS XXXX` 的启动项：

![QQ20190920-173851.png](https://camo.githubusercontent.com/6375d6d36b991a74ca48e233eb79664528193576/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f473763654579417a664f3451536c4c2e706e67)

直接回车即可引导安装程序。接下来安装程序会开始跑代码，别紧张，尽管你可能看到一些 `error, failed` 等关键词，但这一般是正常的日志。等待约 3\~5 分钟出现 `DSMOS has arrived` 的时候，你就能看到 macOS 的安装实用工具了。

当然，多数情况下你可能不会顺利地进入到安装程序，如遇到日志卡住、panic、禁行等，你可以参考[这篇文章](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da.md)查找对应问题的解决方案。

{% hint style="info" %}
Tips: 如果你无法进入安装程序，那么请在启动项上按空格键，勾选 `Verbose mode(-v)`, `Set nvidia to VESA(nv_disable=1)`, `Keep symbols on panic(keepsyms=1)`, `Don't reboot on panic(debug=0x100)` 四个选项，选择 `Return` 然后重新尝试引导，如图：\
![QQ20190920-174009.png](https://camo.githubusercontent.com/efeb63848ddf43ce2302664c58a623c51d7c0421/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6f6e6b6562734570506153325447772e706e67)
{% endhint %}

{% hint style="warning" %}
Tips: 如果你是九代同方机型，那么你可能会遇到日志卡在 `apfs_module_start` 或 `VoodooPS2Controller` 等地方不动，以及键盘不可用的问题。解决方案可以在[这里](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da.md#an-zhuang-shi-ka-zai-apfsmodulestart-huo-voodoops-2-controller-deng)找到。
{% endhint %}

## 使用磁盘工具抹掉分区并安装 macOS

如果上一步顺利的话，你应该能看到这样的一个界面：

![image.png](https://camo.githubusercontent.com/1b1ceb4199c0a41d36aedccce368a7325d05b178/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f346a637447716f4d4133534c424b452e706e67)

选择简体中文，点击继续，来到 macOS 实用工具（你看到的可能会和下图不一致）：

![image.png](https://camo.githubusercontent.com/de05afc6dace01728a8144684fc52a6aeee64e3b/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f704d6754416e6938725978643653392e706e67)

首先让我们点击“磁盘工具”，然后找到你刚刚在 Windows 下划分好的分区，点击上面的“抹掉”，设置你的卷标，格式请选择“APFS”（在任何时刻请不要选择带有“加密”字样的分区格式；我们不推荐使用 Mac OS 拓展（日志式）分区格式来安装最新的系统），然后确定：

![image.png](https://camo.githubusercontent.com/6b9c5e3e2cbc144f1c199fea681482dd6c53faea/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f54513379537a697539716b414c6e352e706e67)

{% hint style="danger" %}
Tips: 这一步操作请格外小心，看好了再点确定，如果因为你的高度近视或手抖导致格错盘，引起的系统崩溃或数据丢失，我是不负责任的哦。
{% endhint %}

如果没有任何问题，那么磁盘工具会提示操作成功。如果磁盘工具报错（如报错 "MediaKit报告设备上的空间不足以执行请求的操作“），那么请移步[这篇文章](/an-zhuang-zhong/tiao-zheng-esp-fen-qu-he-zhong-jian-windows-yin-dao.md)查阅解决方案。

## 开始安装 macOS

### 第一阶段安装

退出磁盘工具回到实用工具，然后选择“安装 macOS”。同意许可协议，安装磁盘选择刚刚抹掉的那一个 APFS 分区，再一路下一步，此时安装程序会开始第一阶段的安装——从 U 盘拷贝 macOS 的必要文件到硬盘分区上，如图所示：

![image.png](https://camo.githubusercontent.com/e08db15886807089e46335002d366d5579f8476c/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6a454479416950464f4d6e496c31742e706e67)

根据你的硬盘速度，这一步需要 5\~15 分钟不等，耐心等待直到完成这一阶段的安装并重启电脑。如果在提示”剩余大约 2 分钟“的时候电脑突然自动黑屏重启了，不用担心，这是正常现象。

如果在复制文件的过程出错（如提示文件不完整，卡死在最后两分钟等），那么请移步[这篇文章](/an-zhuang-zhong/an-zhuang-guo-cheng-zhong-de-yi-nan-jie-da.md)查阅解决方案。

### 第二阶段安装

{% hint style="info" %}
Tips: 需要注意的是，引导第二阶段的安装和进入桌面前的设置，可能会遇到内核 panic （即跑日志是卡死并提示 `Please go to http://panic.apple.com ...`）的情况。不用担心，后文会告诉你怎么解决它们。
{% endhint %}

重启后手动进入 Clover 引导程序，此时 Clover 中应该会多出多个引导项，右移选择其中的 `Boot macOS Install from XXX` 开始第二阶段的安装，其中 `XXX` 是你上个阶段设置的分区卷标（注意不要再次进入 U 盘启动项，如果你第二次进入了 `macOS 实用工具`，则说明你选错了启动项）。

如果你选对了启动项，那么第二阶段的安装会自动开始。需要注意的是第二阶段的安装过程中，有可能进度条刚跑两分钟就自动重启了，这是正常的现象，此时你只需要再手动进入一次安装程序即可。取决于硬盘速度，全程大概需要 10\~30 分钟，请耐心等待。电脑可能会自动重启 1\~2 次。

如果你在引导第二阶段的安装时遇到了内核 panic（通常情况是跑日志的时候，突然快速刷屏一堆 kext，最后一行提示 `Please go to http://panic.apple.com ...`），那么请在 Clover 选择硬盘启动项，按 `O`, 进入如下界面：

![image.png](https://camo.githubusercontent.com/2f31e98bc491f2db241b0c9da9a04073850e06ac/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f4c536e57717776414f517335676f682e706e67)

在第一行 `Boot Args:` 上回车，在末尾添加参数 `-x -liluoff` （注意空格，以及注意和已有的参数用空格隔开）。再次回车，选择 `Return` 并引导系统。如果没有意外，就不会产生 panic 了。

如果你在第二阶段安装读条的时候遇到了其它问题，那么请移步[这篇文章](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/%E5%AE%89%E8%A3%85%E8%BF%87%E7%A8%8B%E4%B8%AD%E7%9A%84%E7%96%91%E9%9A%BE%E8%A7%A3%E7%AD%94)查阅解决方案。

## 首次进入系统的用户设置

当第二阶段的安装完成后重启，此时和以后在 Clover 中选择启动项 `Boot macOS from XXX`（其中 XXX 是你的卷标）来进入系统。

如果你在首次进入系统时遇到了内核 panic（通常情况是卡在 `VTDecoderXPCServ` 错误，如下图所示）:

![](https://camo.githubusercontent.com/49be36a2839c4873ca260f65178ec39c86489768/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f31382f334861794e513576694a526c3136472e6a7067)

那么请在 Clover 界面，选择硬盘 macOS 启动项，然后按 O，定位到显卡注入设置（带有 `Graphics Injector` 字样），向下翻勾选 `Inject Intel`，并修改 `*-platform-id` 从 `0x12345678` 修改为 `0x3E9B0000`，Return 并引导即可。

![image.png](https://camo.githubusercontent.com/6975b54ec29999b976af68e8896fd688f4f93cf5/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6c72764632436d354e68654f5956532e706e67)

如果没有其它问题，那么你应该能看到 macOS 的欢迎界面：

![image.png](https://camo.githubusercontent.com/118cb8d3af1bf4981b125f39c37846f849ad45c7/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f546e7858486f7045666a6b53324d492e706e67)

好了，接下来可以全凭你的个人意愿设置了，**唯一需要注意的是，无论什么情况，都不要开启 ”文件保险箱“ 或 ”FileVault“ 功能，否则你的分区将会被加密成 Clover 无法识别的格式。** 如果你没有有线网络环境，那么连接网络时你可以选择”跳过“。

所有设置完成后，你应该能够进入 macOS 的桌面，一睹 macOS 系统的容颜了。

![image.png](https://camo.githubusercontent.com/fc3a6d91ddfb07230a066feb1669eaf3774b279f/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f6a5359776e75746c4847716b505a582e706e67)

![image.png](https://camo.githubusercontent.com/1f78bd108bc0c1a7a92055855e5fec84d3431934/68747470733a2f2f692e6c6f6c692e6e65742f323031392f30392f32302f7576644f6c78394a6a655546536b512e706e67)

恭喜你！到这里，黑苹果 macOS 的安装就已经结束……

## 后续工作

……了吗？

你可能已经发现了许多硬件工作不正常，这是因为驱动没有安装和完善导致的。下一步操作就是替换本仓库的配置文件，使得黑苹果趋于完美。有关内容，请移步 [EFI 替换教程](https://github.com/kirainmoe/hasee-tongfang-macos/wiki/EFI-%E6%9B%BF%E6%8D%A2%E6%95%99%E7%A8%8B). （当然，教程里面的 EFI 仅适用于对应型号的神舟同方机型）