> 面向小白用户，全程在 Mac 上完成：解锁、刷 Recovery、刷 ROM。核心经验：**刷完 Recovery 后不要用电脑重启，断开 USB 再手动进 Recovery**。
---
## 一、你需要提前知道的
### 1. 设备代号别搞错
- **Redmi Note 7** 的代号是 **lavender**
- **Redmi Note 7 Pro** 的代号是 **violet**
ROM、Recovery 必须下载 **lavender** 版本。若误刷 **violet** 的包，会无法启动甚至变砖。
### 2. 会清空手机数据
解锁 Bootloader 和刷机都会清空手机数据，请提前备份重要内容（照片、聊天记录等）。
### 3. 准备工作：一个「工作目录」
在 Mac 上先建一个文件夹，用来放后面要用的所有文件（ROM、Recovery、vbmeta 等）。路径你可以自己定，例如：
- 桌面：`~/Desktop/redminote7`
- 或：`~/Downloads/redminote7`
- 或任意你喜欢的路径
**下文里用「工作目录」代替**，所有「把文件放到工作目录」「在终端里 cd 到工作目录」都是指你建的这一个文件夹。
在终端里进入的方式是（把路径换成你的）：
```bash
cd ~/Desktop/redminote7
```
---
## 二、Mac 环境准备
### 1. 安装 Homebrew（若尚未安装）
打开 **终端（Terminal）**，执行：
```bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
按提示完成安装。
### 2. 安装 ADB 和 Fastboot
```bash
brew install android-platform-tools
```
装好后可在终端输入 `adb version`、`fastboot version` 检查是否安装成功。
### 3. 安装 uv（用于后面在 Mac 上解锁）
```bash
brew install uv
```
### 4. 安装 MiUnlockTool（仅解锁时需要）
在工作目录下执行（**先 cd 到你的工作目录**）：
```bash
cd 你的工作目录路径 # 例如：cd ~/Desktop/redminote7
# 创建 Python 虚拟环境并安装 MiUnlockTool
uv venv
uv pip install --python .venv/bin/python miunlock
```
以后每次要用 MiUnlockTool，都是先 `cd` 到该目录，再执行：
```bash
.venv/bin/miunlock
```
---
## 三、准备刷机文件（全部放到工作目录）
### 1. LineageOS ROM
- 下载地址（lavender 专用）：
https://sourceforge.net/projects/lavender-roms/files/Rom/4.19/
- 选择 **Lineage-23.0** 或 **Lineage-23.1** 目录，下载里面的 **.zip**（约 1.1GB）
- 文件名应包含 **lavender**，例如：`lineage-23.0-lavender-20251206-0853.zip`
- 下载完成后，把该 zip **放到你的工作目录**
### 2. 校验 ROM 是否完整（建议做）
在终端执行（把文件名改成你下载的）：
```bash
cd 你的工作目录路径
unzip -t lineage-23.0-lavender-20251206-0853.zip
```
最后一行应出现 **No errors detected**。若有报错，说明下载不完整，需重新下载。
### 3. TWRP Recovery
- 下载地址：
https://sourceforge.net/projects/recovery-for-xiaomi-devices/files/lavender/
- 下载 **twrp-3.6.1_9-0-lavender.img** 或 **twrp-3.7.0_9-0-lavender-TeamWin.img**
- 将 **.img** 文件放到**工作目录**
### 4. 从 ROM 里取出 vbmeta.img
后面要用来关闭验证，才能正常进 Recovery。在终端执行（文件名改成你的 ROM 名）：
```bash
cd 你的工作目录路径
unzip -j lineage-23.0-lavender-20251206-0853.zip vbmeta.img
```
解压后工作目录里会多出一个 **vbmeta.img**。
---
## 四、解锁 Bootloader（若尚未解锁）
若你刷 Recovery 时出现 **Flashing is not allowed in Lock State**，说明还没解锁，需要先做这一步。
1. 手机开机进系统，用 USB 连上 Mac，在 **设置 → 开发者选项** 里开启 **USB 调试**，并完成 **绑定设备与小米账号**（MI Unlock 状态里）。
2. 在 Mac 终端执行：
```bash
cd 你的工作目录路径
.venv/bin/miunlock
```
3. 按提示输入小米账号/手机号等，完成获取 token 的流程；若工具提示需在 Windows 上继续，则按提示操作。
4. 解锁会清除手机数据，完成后手机会重启。
---
## 五、把 ROM 拷进手机（在刷 Recovery 之前做）
1. 手机**开机进系统**（MIUI），用 USB 连 Mac，在手机上允许 USB 调试。
2. 终端执行（路径和 zip 名改成你的）：
```bash
cd 你的工作目录路径
adb push lineage-23.0-lavender-20251206-0853.zip /sdcard/
```
等待传输完成（约 1GB，几分钟）。ROM 会出现在手机存储根目录，后面在 Recovery 里选这个 zip 刷入即可。
---
## 六、刷入 vbmeta 和 Recovery（关键步骤）
### 1. 进入 Fastboot
- 手机关机后，**同时按住 音量下 + 电源键**，直到屏幕出现 Fastboot 界面（一只兔子或 Fastboot 字样）。
- 用 USB 连接 Mac，终端执行：
```bash
fastboot devices
```
若能看到一列设备号加 `fastboot`，说明连接正常。
### 2. 刷 vbmeta 和 Recovery
在终端执行（**先 cd 到工作目录**，文件名按你实际用的改）：
```bash
cd 你的工作目录路径
# 关闭验证，否则自定义 Recovery 无法启动
fastboot flash vbmeta vbmeta.img
# 刷入 TWRP（.img 文件名改成你下载的）
fastboot flash recovery twrp-3.6.1_9-0-lavender.img
```
看到 **OKAY** 即表示写入成功。
### 3. 核心：不要用电脑重启，手动进 Recovery
**不要**在终端执行 `fastboot reboot` 或 `fastboot reboot recovery`，否则很容易又进 MIUI，Recovery 被覆盖或进不去。
正确做法：
1. **直接拔掉 USB 线**，断开手机和 Mac 的连接。
2. 在手机上 **长按电源键** 关机（若已在 Fastboot 界面，多按一会儿即可关机）。
3. 关机后，**同时按住 音量上 + 电源键**，直到屏幕亮起并进入 **TWRP** 界面（蓝色/橙色 UI，有 Install、Wipe 等按钮）。
这样是「从关机状态直接进 Recovery」，避免被系统或 Bootloader 干扰。
---
## 七、在 Recovery 里刷入 LineageOS
### 1. 清除数据（Wipe）
- 在 TWRP 主界面点 **Wipe** → **Advanced Wipe**。
- 勾选：**Dalvik / ART Cache**、**Cache**、**Data**、**System**。
- **不要勾 Internal Storage**（除非你要清空整个手机）。
- 然后 **Swipe to Wipe** 滑动确认。
### 2. 刷入 ROM
- 返回主界面，点 **Install**。
- 进入根目录或 **/sdcard/**，找到你之前 adb push 进去的 **lineage-23.0-lavender-xxx.zip**（或你下载的 ROM 文件名）。
- 点选该 zip，再 **Swipe to confirm Flash** 开始刷入。
- 等待完成（几分钟）。
### 3. 如需 GApps 或 Root 内核
在同一界面继续 **Install**，选择对应的 zip 刷入（GApps、Kernel 等需与 ROM 版本匹配）。没有需求可跳过。
### 4. 重启进系统
- 点 **Reboot** → **System**。
- 若提示是否安装 Root 等，按需选择（一般选 Do Not Install 即可）。
- 首次开机可能 **5～10 分钟**，属正常现象。
---
## 八、常见问题
| 现象 | 说明与处理 |
|------|------------|
| `Flashing is not allowed in Lock State` | Bootloader 未解锁，按第四节在 Mac 上用 MiUnlockTool 解锁。 |
| `Failed to load/authenticate boot image` | 未刷 vbmeta 或验证未关，先执行 `fastboot flash vbmeta vbmeta.img` 再刷 recovery。 |
| 刷完 recovery 后重启又进 MIUI | **不要用 fastboot 重启**；按第六节：拔 USB → 关机 → **音量上 + 电源键** 进 Recovery。 |
| Recovery 里提示「签名不一致」 | 第三方 ROM 正常，选「是」继续安装即可。 |
| 不确定 ROM 是否适合自己机型 | 只刷文件名里带 **lavender** 的包；**violet** 是 Note 7 Pro，不能混用。 |
| `adb devices` 显示 `unauthorized` | 手机弹出「允许 USB 调试」时要点允许，并可选「始终允许」。 |
---
## 九、小结（Mac 刷机要点）
1. **工作目录**：自己建一个文件夹（如桌面上的 `redminote7`），所有 ROM、Recovery、vbmeta 都放这里；终端里用 `cd` 进入该路径。
2. **环境**：Mac 上装好 Homebrew、android-platform-tools（adb/fastboot）、uv，以及在工作目录里用 uv 安装 MiUnlockTool。
3. **设备代号**：只使用 **lavender** 的 ROM 和 Recovery，不要用 violet。
4. **最关键的一步**：刷完 Recovery 后**不要执行 fastboot 重启**，而是**断开 USB → 关机 → 音量上 + 电源键** 进入 Recovery，再在 TWRP 里 Wipe 并刷入 LineageOS zip。
按以上步骤，在 Mac 上即可完成从解锁到刷机的全部流程。若你愿意，可以把「工作目录」固定成同一个路径，以后升级 ROM 或换版本时，只需替换 zip 和 vbmeta，再重复第六、七节即可。
