# 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 仅适用于对应型号的神舟同方机型）


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://hackintosh.kirainmoe.com/an-zhuang-zhong/macos-an-zhuang-jian-ming-jiao-cheng.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.