⚠️ 重要声明：风险自负

刷机有风险,操作不当可能导致设备变砖（无法开机）、数据丢失、功能异常等严重问题，请仔细阅读每一步，确保你理解每一个操作的含义。

第一部分：准备工作

在开始之前,请务必完成以下所有准备工作，这是成功刷机的关键。

确认设备型号

这是最最重要的一步！错误的设备型号会导致刷入错误的固件，直接变砖。

• 进入“关于手机”
  • 打开手机的 设置 > 关于手机 > 型号名称 或 设备型号，记下这个完整的名称（Pixel 7 或 Xiaomi 12）。
• 在已解锁 Bootloader 的设备上
  • 如果你的设备已经解锁了 Bootloader，在 Bootloader 模式下输入 fastboot devices 或 adb devices，设备 ID 旁边通常会显示型号代码。

检查设备是否支持 LineageOS

并非所有设备都支持 LineageOS，你需要去官方社区查询。

• 访问官方设备列表：https://wiki.lineageos.org/devices
• 在页面按 Ctrl+F 搜索你的设备型号。
• 如果你的设备在列表中,恭喜你！页面会提供所有你需要下载的文件链接和专属的刷机指南。请务必仔细阅读你的专属指南，因为它可能包含一些通用教程没有的特殊步骤。

解锁 Bootloader

刷机必须先解锁 Bootloader，这会清除手机上所有的数据，请务必备份！

• 解锁步骤：
  1. 备份！备份！备份！ 使用云服务（Google Drive, iCloud）或电脑（使用 adb backup）备份所有重要数据。
  2. 在手机上 开启“开发者选项” 和 “USB 调试”。
     • 进入 设置 > 关于手机，连续点击 “版本号” 7 次，直到提示“您已处于开发者模式”。
     • 返回 设置 > 系统 > 开发者选项，开启 “USB 调试”。
  3. 将手机连接到电脑。
  4. 在电脑上打开命令提示符 或 PowerShell (Windows) 或终端 (macOS/Linux)。
  5. 输入以下命令,检查设备是否被识别：

     adb devices

     如果看到设备 ID 和 unauthorized，请在手机上弹出的授权窗口中点击“允许”。

  6. 输入以下命令解锁 Bootloader（此操作会清除所有数据）：

     adb reboot bootloader

     手机将重启进入 Bootloader 模式（屏幕上通常有 Android 小机器人）。

  7. 在 Bootloader 模式下，输入以下命令：

     fastboot flashing unlock

  8. 手机屏幕上会出现解锁警告,使用音量键选择“是”，电源键确认。
  9. 解锁完成后,手机会自动重启，你的手机已经是一个“纯净”的状态，没有任何数据。

下载所需文件

在你的电脑上,为你的设备下载以下所有文件。确保下载的文件与你的设备型号完全匹配！

1. LineageOS 安装包

   
   （图片来源网络，侵删）
   • 从 LineageOS 官方下载页面 下载最新版本的 .zip 文件。
   • 文件名通常类似 lineage-xx.x.x-YYYYMMDD-nightly-your_device.zip。

2. OpenGApps (可选，但推荐)

   • LineageOS 是一个“干净”的 Android 系统，不包含 Google 服务框架（如 Gmail, Google Play 商店等），如果你需要这些服务，必须下载 OpenGApps。
   • 访问 OpenGApps 官网。
   • 平台：选择 arm 或 arm64 (取决于你的设备 CPU，64 位设备选 arm64)。
   • 变种：强烈推荐 pico，它只包含最核心的 Google 服务，体积小且稳定，如果需要更多应用，可选 nano。
   • Android 版本：选择与你下载的 LineageOS 版本匹配的 Android 版本（LineageOS 20 基于 Android 13）。
   • 下载并解压，你会得到一个 OpenGApps-...-...-...-pico.zip 文件。

3. Magisk (可选，但强烈推荐)

   • Magisk 是一个强大的 Root 工具，同时也是系统修补工具，刷入 Magisk 可以让你以更安全的方式 Root，并隐藏 Root 状态，同时也能修补 Boot 镜像以防止某些安全检测。
   • 访问 Magisk 官方 GitHub 发布页。
   • 下载最新版的 Magisk.apk 或 Magisk.zip，在刷机时，我们需要 zip 文件。

准备工具

• 电脑：Windows, macOS 或 Linux。
• 数据线：质量良好的原装或认证数据线。
• ADB 和 Fastboot 驱动：
  • Windows: 最简单的方法是下载 Platform Tools 并解压，教程中我们将直接使用这个工具包。
  • macOS / Linux: 通常系统自带 adb 和 fastboot，如果没有，可以通过包管理器安装（如 brew install android-platform-tools）。

第二部分：刷机步骤

所有准备工作都已完成,可以开始刷机了。

步骤 1：将文件传输到手机

1. 将你的手机通过 USB 连接到电脑。
2. 在手机上,从通知栏下拉，选择 “正在为该充电” > “文件传输” 模式。
3. 在电脑上,打开你的手机存储。
4. 将以下三个文件复制到手机根目录的 Download 文件夹中：
   • lineage-...-your_device.zip
   • OpenGApps-...-...-...-pico.zip (如果你选择安装)
   • `Magisk-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...-...