2026 年的 Magisk：当前版本、v31 的变化与更稳妥的更新方式

找到更新的 Magisk APK 很容易，真正值得花心思的，是判断它该不该装到你依赖的那部手机上。

某个版本可能修复了 Android 兼容性问题，却没有修好你的模块。更新应用，也未必会同时更新已安装的 Root 组件。而支付类应用拒绝运行，并不自动说明你的 Magisk 安装出了问题。

在 2026 年 9 月 28 日的研究核查时，官方项目把 Magisk v30.7 标为最新稳定版，把 v31.0 标为预发布版。第 31 版带来了重新设计的应用、终端界面和远程 OTA 镜像提取等变化。请以官方的发布标签为准，而不是只看版本号最高的那个。来源 1来源 2

本指南说明改了什么、更新前该核实什么，以及如何避免把一个兼容性问题变成好几个。

一览：当前 Magisk 版本

日期来自官方更新日志，当前渠道标签来自对应的发布页面。来源 3来源 1来源 2

这张表是带日期的参考，并不保证某个版本会一直保持现在的状态。安装前，请打开官方项目，确认标签、发布说明，以及它是否被标为预发布版。

避开那些把每个新构建都标成“稳定版”，或把无关模块捆进所谓官方包的第三方下载页。

Magisk 31 实际改变了什么

重新设计的应用与功能更强的终端界面

v31 的发布说明提到，新界面基于 Compose 和 Material 3，并内置了终端，支持 TTY 交互和 ANSI 输出，可用于模块安装和各种操作。来源 2

对读者来说，有用的问题不是新界面看起来有什么不同，而是你正在照着做的模块说明，是否仍与你所装版本中的控件和行为一致。

这个终端也不等同于 Android 自带的 Debian Linux 环境。想了解两者的对比，请看Android 的 Linux Terminal 与 Termux 对比。

从远程 OTA 中提取镜像

第 31 版新增了直接从远程 OTA 链接中提取 boot 镜像的功能。来源 2

这可以减少手动下载和解包大型固件包的麻烦，但并不会让固件选择自动化，也不会默认就可信。你仍然需要正确的设备、版本号、地区和固件来源。

提取功能无法让不匹配的镜像适合你的手机。修补之前，请保留未修改的原始文件，并按照查找正确 boot 或 init_boot 镜像的指南操作。

Boot 镜像处理与 Android 17 适配

该版本包含与 AVB 相关的镜像处理改动，以及对 Android 17 / API 37 的 Zygisk 支持。来源 2

这些是具体的实现层面的改动，并不保证所有厂商的 boot 包或所有第三方模块都能正常工作。依赖 Android 内部实现的模块，仍可能需要自己的更新。

除非每一行都有针对实际手机、固件和模块版本的证据，否则不要把“支持 Android 17”变成一张通用的兼容性对照表。

稳定版 v30.7 解决了什么

30.7 版包含针对 Android 16 QPR2 的 SELinux 策略处理，以及针对 QPR2 及更高版本的 Zygisk 兼容性适配，另有其他有针对性的修复。来源 1

所以当旧安装遇到这些具体的平台变化时，它才有意义。这并不说明 Android 16 手机上的每个症状都出于同一个原因。

先看与你的问题对应的发布说明。固件提取失败、模块操作出错和银行类应用警告是不同的问题，即使发生在同一部手机上。

已经正常工作的 Magisk，需要更新吗？

我的建议是，让更新对应一个具体的需求。请用下面这张决策表，不要把最新的标签当成必须升级的版本。

稳定版标签不是对所有设备专属故障的担保，预发布版标签也不能证明某个构建无法使用。实际的区别在于：你需要准备好调查和恢复多大程度的不确定性。

对于主力手机，不要把第一次尝试安排在旅行、上班或任何依赖稳定移动网络的活动之前。

应用版本与已安装的 Magisk 版本是两项不同的检查

打开 Magisk，同时查看应用信息和已安装的 Magisk 状态。不要想当然地认为装上更新的 APK，就一定完成了所有必要的安装步骤。

对于已有且可访问的安装，官方命令行工具会区分二进制文件与正在运行的守护进程：

magisk -c
magisk -v
magisk -V

这些命令分别显示当前二进制版本、正在运行的守护进程版本，以及守护进程的版本号（version code）。只能在你现有 Magisk 安装可用的 shell 中运行它们。它们是版本检查，不是安装命令。来源 4

有两种经常被重复的诊断错误，值得纠正：

• magisk --list 列出的是可用的 applet，并不会列出你已安装的模块。
• magisk --denylist status 报告的是 DenyList 的执行状态，并不是通用的 Zygisk 健康检查。来源 4

请使用应用中的模块列表和文档记载的模块专用诊断方式，而不要给命令输出赋予别的含义。

应用提示 Magisk 未安装怎么办？

官方 FAQ 指出，应用存根以及多用户或用户配置文件的情况，可能导致应用表现具有误导性。来源 5 重新安装固件之前，先记录应用显示了什么，以及现有二进制文件报告了什么（若有报告）。

应用显示缺失，与设备无法启动，需要走不同的恢复路径。不要因为两个问题都与 Magisk 有关，就直接用最激进的修复方式。

改动安装之前，先准备好恢复文件

记录下确切的 Android 版本号、当前的 Magisk 版本和已安装的模块。把恢复说明保存在你即将改动的这部手机之外的地方。

必备的是：一份最新的备份、你自己确认没问题的原厂固件镜像，以及能与设备通信的可用方式。云备份不能代替你去检查那些数据对你很重要的应用的导出与恢复流程。

如果你的电脑现在检测不到设备，请先解决这个问题。我们的Fastboot 检测指南讲的就是这个独立的问题。

Magisk 的安装说明会区分 boot、init_boot 和基于 Recovery 的几种情况，并单独记录了 Samsung 的流程。它们还提醒不要使用别人修补好的镜像。来源 6

Samsung 设备不要拿通用的 fastboot 命令去替代该设备文档里的 AP 包流程。其他设备，不要仅凭当前的 Android 版本来决定分区。请严格按照该设备和固件对应的安装路径来做。

把普通 Magisk 更新和 Android OTA 分开处理

普通的 Magisk 更新改变的是 Magisk，而 Android OTA 改变的是操作系统，还可能改动安装所涉及的 boot 镜像。

项目文档中的 OTA 流程，包括还原镜像，以及在适用的 A/B 设备上，在 OTA 重启之前的特定时间点安装到非活动槽位。来源 7 这条说明并不适用于每一个更新界面。

在选择非活动槽位选项之前，你应该能说清楚：已经装了哪一次更新、它准备的是哪个槽位，以及手机此后是否重启过。如果说不清，就先停下来，核实整个步骤顺序。

不要为了让不确定性消失，就手动切换槽位或同时刷两个槽位。恢复操作和最初的安装一样，需要针对具体设备的谨慎。

如果问题出现在系统更新期间，请使用已 Root 手机的 OTA 故障排查指南，不要随便套一份模块更新清单。

一次只更新一层

不要在同一次操作中，既更新操作系统，又更换 Root 管理器，又安装另一种 Zygisk 实现，还一口气添加好几个模块。

即使最终配置能用，这种做法也几乎无法让你知道哪项改动才是必要的。一旦失败，就会留下好几个可能的原因。

更有用的顺序是：记录正常工作的状态，只改你打算改的那个组件，在其文档要求时重启，再确认手机的日常功能正常，然后才进行下一步。

检查通话、Wi-Fi、移动数据、相机，以及你真正依赖的那些应用。保留一份简短的改动记录。一周之后，仅凭“全都更新了”这几个字，是不足以恢复这套配置的。

模块兼容性由模块维护者负责

并不存在每部已 Root 手机都需要的通用模块清单。安装之前，应该能够看懂模块的作用、依赖项和兼容性说明。

为每个模块记录来源仓库、版本、用途和移除方法。如果两个工具声称修改同一个子系统，就应该研究它们之间的相互作用，而不是假定组合起来更强。

一条很早之前写着某模块“在 Android 16 上可用”的评论，并不是对你的 Android 版本、ROM 和当前版本的测试。要找可复现的问题报告和维护者的回复，而不是只看成功截图。

有 Root 权限不等于保证支持 Google Wallet 或银行类应用

Google Wallet 列出了一些安全要求，被修改过、已 Root、使用第三方 ROM 或已解锁 BL 的设备可能无法满足。来源 8 Magisk 自己的 FAQ 也说明，隐藏 Root 已不再是该项目的责任。来源 5

最近 r/Magisk 上的一场讨论说明了这种混乱。参与者反映 Wallet 出现故障，同时又说完整性检测是通过的，而且他们报告的结果各不相同。来源 9

这些是用户的反馈，既不是经过独立验证的设备状态证明结果，也不能证明某个单一的服务器端原因。它们足以说明，为什么完整性检测应用的一张截图，不应成为对另一个应用行为的保证。

不要仅仅因为某个模块清单看似相近的人这样建议，就格式化一部运行正常的手机。先弄清具体的警告内容，以及应用提供方的要求。

如果某个必须使用的金融类应用不支持你修改过的配置，可靠的选择可能是：恢复到受支持的原厂配置，或另用一部受支持的设备。恢复固件和重新锁定 BL，必须遵循厂商的正确流程；对任意修改过的镜像重新上锁，不是安全的捷径。

按最近一次改动来诊断故障

Magisk 记录了与模块相关的启动问题的恢复选项，包括在受支持配置上的安全模式行为。来源 5 请参照Magisk 刷入与恢复指南，让处理方法与实际症状对应。

对未经解释就复制来的命令要格外小心。例如 magisk --remove-modules 会移除所有模块，并且通常会重启。它不是只读的诊断命令，也不是只禁用某一个模块的方法。来源 4

对早期版本的更正

本文的早期版本包含不正确的发布日期和过于宽泛的兼容性说法。这一版用官方发布信息替换了那些说法，并把应用更新、已安装的 Magisk、模块行为和支付类应用的要求区分开来。本文不宣称存在一种普遍有效的隐藏 Root 配置，也不提供实际操作的成功率。

常见问题

Magisk 31 是当前稳定版吗？

在 2026 年 9 月 28 日核查时不是。它的发布页面被标为预发布版，而 v30.7 带有最新稳定版标签。来源 1来源 2 安装时请再次核对官方标签。

更新 Magisk 能修好所有 Android 17 模块吗？

不能。Magisk 的支持与第三方模块的兼容性是两回事。请阅读该模块当前的文档和 issue。

装上 APK 就算更新完成了吗？

不要这样假定。先检查应用和已安装的状态，再按现有设备配置对应的文档流程完成安装。

“Install to Inactive Slot”每次都是最安全的选项吗？

不是。它属于特定的、受支持的 OTA 流程，并不适用于每一次普通的 Magisk 更新。来源 7

银行类应用不能用了，我该降级吗？

没有证据表明是版本变化造成的问题，就不要降级。在改动固件或删除数据之前，先检查具体报错和银行类应用的支持要求。

把更新做得清楚明白

好的更新，是你能够解释清楚的更新：装的是哪个版本、为什么选它、还改动了什么，以及你打算如何恢复。

把官方发布状态、原始固件和模块来源放在一起保存。这点小小的准备，比一份与你实际手机毫无关系的长长的“必装模块”清单更有用。

来源与范围

研究核查日期：2026 年 9 月 28 日。发布标签可能会变化。社区经验均注明出处，不当作可复现的测试来呈现。本文没有进行任何设备 Root、刷机、支付测试或模块兼容性基准测试。

• 来源 1：Magisk 官方 v30.7 发布页面、最新稳定版标签和发布说明。打开来源
• 来源 2：Magisk 官方 v31.0 预发布版、发布日期和功能列表。打开来源
• 来源 3：Magisk 官方更新日志，历史版本日期。打开来源
• 来源 4：Magisk 官方 Tools 文档，命令含义以及模块移除的破坏性行为。打开来源
• 来源 5：Magisk 官方 FAQ，隐藏 Root 的范围、已安装状态问题和模块恢复。打开来源
• 来源 6：Magisk 官方安装说明，镜像选择、针对特定设备的流程和修补镜像警告。打开来源
• 来源 7：Magisk 官方 OTA 升级指引。打开来源
• 来源 8：Google Wallet 帮助，非接触式支付与设备安全要求。打开来源
• 来源 9：r/Magisk 上关于 Wallet 故障的讨论，用户同时反映完整性检测结果为通过。仅为个例，并非经独立复现的测试。打开来源