⚠️ 重要声明：风险与责任

在开始之前,请务必了解以下信息：

1. 保修失效：对手机进行刷机（包括解锁 Bootloader）通常会使你的设备官方保修失效。
2. 变砖风险：尽管现代 Android 设备的安全性很高，但任何操作都存在极小的“变砖”（设备无法启动）风险,请严格按照教程步骤操作。
3. 数据丢失：解锁 Bootloader 会清除手机上所有数据，包括照片、联系人、应用等,请务必备份！
4. 银行/支付应用：Magisk 是一个强大的 Root 工具，很多银行、金融支付类应用（如支付宝、微信支付）会检测到 Root 环境并限制其使用，请了解 Root 带来的便利与限制。
5. 教程通用性：本教程基于通用流程，不同品牌（如三星、小米、Pixel）和不同型号的手机可能在具体操作（如解锁 Bootloader 的按键组合）上略有差异,请以你手机品牌官方指南为准。

第零步：准备工作（这是最重要的一步！）

在开始任何操作之前,请确保你已经完成以下所有准备工作：

备份！备份！备份！

这是最最重要的一步,没有之一！

• 系统数据备份：使用手机自带的云服务（如小米云、华为云、三星会员）或第三方工具（如 Helium）备份你的应用数据、联系人、短信等。
• 本地文件备份：将照片、视频、文档等重要文件手动复制到电脑或云端。
• 完整系统备份（可选但推荐）：使用 TWRP 或其他第三方 Recovery 进行完整的系统镜像备份，这样即使刷机失败,也能轻松恢复到原系统。

解锁 Bootloader

Root 的前提是解锁 Bootloader，Bootloader 是手机启动时加载的第一个软件，它负责加载 Android 系统，解锁它允许你安装自定义 Recovery（如 TWRP）和修改系统分区。

通用解锁流程（具体按键组合请自行搜索你的手机型号 + "解锁 Bootloader"）：

1. 开启 OEM 解锁和 USB 调试：

   • 进入 设置 -> 关于手机，连续点击 版本号 7 次，直到提示“你已处于开发者模式”。
   • 返回 设置 -> 系统 -> 开发者选项，开启 OEM 解锁 和 USB 调试。

2. 连接电脑并执行命令：

   • 在电脑上安装对应手机的 USB 驱动程序。

   • 在电脑上下载 Platform Tools 并解压。

   • 将手机通过 USB 线连接到电脑，确保选择“文件传输”模式。

   • 打开电脑的命令提示符 或 PowerShell (Windows) / 终端 (macOS/Linux)，进入你解压 Platform Tools 的目录。

   • 在命令行中输入以下命令：

     # 检查设备是否连接正常
     adb devices
     # 重启手机到 Bootloader 模式
     adb reboot bootloader

3. 在 Bootloader 模式下解锁：

   • 手机屏幕会显示 Bootloader 界面,通常有锁定状态。
   • 在电脑命令行中输入解锁命令（此操作会清除所有数据！）：

     fastboot flashing unlock

   • 使用音量键选择 Yes,电源键确认。
   • 手机将自动重启并进入初始设置界面，Bootloader 解锁完成。

刷入第三方 Recovery（推荐 TWRP）

Magisk 的安装通常需要一个自定义 Recovery 环境，TWRP 是最流行、功能最强大的选择。

1. 下载 TWRP 镜像文件：
   • 访问 官方 TWRP 网站。
   • 在网站上找到你的手机型号（OnePlus 8）,点击进入下载页面。
   • 下载对应你手机型号的 TWRP 镜像文件（通常是 .img 后缀）。
2. 刷入 TWRP：
   • 确保手机已解锁 Bootloader 并处于 Bootloader 模式（如果没有，用 adb reboot bootloader 重启）。
   • 将下载好的 TWRP .img 文件复制到 Platform Tools 文件夹中。
   • 在电脑命令行中使用以下命令刷入（将 twrp-3.7.0_12-0-oneplus8.img 替换为你下载的文件名）：

     fastboot flash recovery twrp-3.7.0_12-0-oneplus8.img

   • 刷入成功后，为了避免被官方 Recovery 覆盖，我们需要禁用它的自动更新，在 Bootloader 界面，输入以下命令：

     fastboot flash --disable-verification recovery twrp-3.7.0_12-0-oneplus8.img

   • 重启手机到 Recovery 模式（在 Bootloader 界面选择 Recovery）。
   • 首次启动 TWRP 时，它会提示你 "Keep Root" 或 "System As Root"，请选择 "Keep Root",这一步至关重要！

第一步：获取 Magisk 安装包

1. 下载 Magisk App (推荐)：
   • 最简单的方式是直接在手机上安装最新的 Magisk App，你可以在 GitHub Releases 页面 下载最新的 .apk 安装包。
   • 由于 Magisk 可能被一些应用商店或安全软件误报,建议从官方渠道下载。
2. 下载 Magisk 安装包 (备用)：
   • 如果你无法在手机上安装 App，也可以下载一个完整的 Magisk.zip 文件，这个文件同样在 GitHub Releases 页面可以找到，通常文件名中包含 stable 或 canary。

第二步：通过 TWRP 安装 Magisk

你的手机已经解锁 Bootloader 并安装了 TWRP Recovery，可以开始安装 Magisk 了。

1. 将 Magisk 文件传入手机：
   • 将你下载的 Magisk-vXX.X.apk 或 Magisk-vXX.X.zip 文件通过 USB 线复制到手机存储的根目录（Download 文件夹或根目录）。
2. 重启到 TWRP Recovery：
   • 如果手机已经开机，长按电源键，在弹出的菜单中选择 Reboot -> Recovery。
   • 如果手机已关机，在 Bootloader 模式下选择 Recovery。
3. 在 TWRP 中安装 Magisk：
   • 进入 TWRP 后,你会看到主界面。
   • 点击 Install（安装）按钮。
   • 在文件列表中，找到你刚才复制到手机的 Magisk 文件。
     • 如果你下载的是 .apk 文件：TWRP 可能无法直接识别，最好的方法是在手机上正常安装这个 APK，它会自动将安装包解压到 Internal Storage 的 Download 目录下，并生成一个 .zip 文件，返回 TWRP 的 Install 界面，刷新一下列表，就能找到这个 ZIP 文件进行安装。
     • 如果你下载的是 .zip 文件：直接选择它。
   • 滑动按钮确认安装。
   • 安装过程很快，完成后会返回 TWRP 主界面。

第三步：首次启动并完成设置

1. 重启系统：
   • 在 TWRP 主界面，点击 Reboot（重启）。
   • 不要选择 Reboot to Bootloader 或 Reboot to Recovery，一定要选择 Reboot System（重启系统）。
2. 首次启动：
   • 第一次重启会比平时慢很多，请耐心等待，可能会出现多次开机动画循环，这是正常的,系统正在进行首次启动的优化。
   • 进入系统后，你会发现桌面上出现了 Magisk App 的图标。
3. 打开 Magisk App：
   • 打开 Magisk App，它会提示你安装或更新，点击 Install。
   • 它会自动完成最后的一些设置（如安装 Magisk Hide 等），然后提示你 Installation Success。
   • 在 App 的 Magisk Hide (应用隐藏) 页面，你可以选择需要隐藏 Root 状态的应用（如支付宝、游戏等）,勾选即可。

第四步：验证 Root 是否成功

1. 使用 Root Checker App
   • 在 Google Play 商店或 F-Droid 上下载一个 "Root Checker" 应用。
   • 打开它，点击 "Verify Root Access"。
   • 如果显示 "Root access is properly installed!"，恭喜你，Root 成功！
2. 使用终端 App
   • 在手机上安装一个终端模拟器 App（如 Termux）。
   • 打开 Termux，输入命令 su。
   • 如果弹窗请求授予 Root 权限，并且命令提示符从 变成了 ，则说明 Root 成功。

常见问题与注意事项

• 问题：刷入 Magisk 后无法开机（卡在开机动画）。
  • 解决：这通常是因为 Magisk 与你的系统版本不兼容或模块冲突，你需要再次进入 TWRP Recovery，选择 Wipe -> Advanced Wipe，只勾选 Dalvik/ART Cache、Cache 和 System，然后重新安装 Magisk.zip。
• 问题：Magisk App 显示 Magisk is not installed。
  • 解决：这通常是因为你安装的是 Magisk.zip 但没有在 TWRP 中完成最后一步，请重启到 TWRP，再重新安装一次 Magisk.zip。
• 如何更新 Magisk？
  • 直接在 Magisk App 内点击 Update,它会下载最新的安装包并引导你完成更新。
• 如何卸载 Magisk？
  • 重要：卸载 Magisk 会让你失去 Root 权限，但不会重新锁定 Bootloader。
  • 进入 TWRP Recovery，选择 Advanced -> Uninstall Magisk,然后重启。
  • 如果你想恢复到完全纯净的系统，你需要进入 TWRP，进行 Factory Reset (恢复出厂设置)，这会清除所有数据，包括你之前刷入的 Magisk 和所有模块，然后你可以通过官方的电脑端软件（如小米的 Mi Flash、三星的 Smart Switch）刷入官方原厂包来恢复系统。

恭喜你！现在你已经成功掌握了 Magisk 的安装与使用，你可以开始探索 Magisk 的强大功能，如安装模块（Adaway 广告屏蔽、Gesture Navigation 手势导航增强等）和应用隐藏了。