LSPosed 安装与使用教程（配合 Magisk）

LSPosed 与 Xposed 是什么关系

Xposed 是 Android 上最早成体系的模块化框架，它通过修改系统运行时，让模块在不改动应用安装包的情况下改变应用行为。早期的 Xposed 依赖修改系统文件，兼容性和维护成本都很高，后续版本逐渐停止更新。

LSPosed 是这条技术路线上的后继实现之一，运行在 Magisk 提供的环境里，采用“模块 + 作用域”的设计。它本身由两部分组成：

• 一个刷入 Magisk 的模块包，负责提供框架运行环境。
• 一个管理器应用，用来启用模块、配置作用域、查看日志。

与早期方案相比，LSPosed 最大的变化是作用域：模块不再默认影响所有应用，而是只对你勾选的应用生效。这既降低了冲突概率，也让问题更容易定位。

安装前提

安装前需要满足几个条件：

1. 手机已经完成 Root，并且 Magisk 可以正常工作。没有 Root 就没有挂载模块的环境。
2. Magisk 的 Zygisk 功能已开启。较新的 LSPosed 版本依赖 Zygisk 提供注入能力，未开启时框架无法激活。
3. Android 版本在支持范围内。具体支持区间以项目发布页的说明为准，过新的系统版本往往需要等待适配。
4. 机型架构匹配。多数设备是 arm64，少数老旧设备不同，下载错架构的包会直接安装失败。

如果还没有 Root，先按 安卓手机 Root 完整教程 完成前面的步骤，再回来装框架。顺序不能颠倒。

安装步骤

1. 从项目发布页获取模块 zip。不要使用来源不明的“整合包”，框架类文件被篡改的后果比普通模块严重得多。
2. 打开 Magisk 管理器，进入模块页面，选择“从本地安装”，选中 zip。
3. 等待刷入完成，重启手机。首次启动时间可能略长。
4. 重启后确认管理器入口。部分版本会在桌面生成图标，部分版本需要在拨号界面输入特定号码或通过通知进入，具体方式以发布说明为准。
5. 打开管理器，查看框架状态。显示已激活即表示环境正常；显示未激活则回到上一步排查。

安装过程本身不复杂，难的是后续的模块管理。建议在装完框架后先什么都不装，确认系统稳定，再逐个添加功能模块。

模块作用域是什么意思

作用域指的是“这个模块对哪些应用生效”。在管理器里，每个模块都有一份应用列表，勾选即启用，取消即关闭。

理解作用域要注意几点：

• 作用域只决定模块代码是否被加载到目标应用进程，模块具体做什么仍由模块自身决定。
• 勾选系统框架会扩大影响范围，风险明显高于只勾选单个应用。
• 同一个应用被多个模块勾选时，可能同时被修改，冲突难以避免。
• 修改作用域后通常需要强制停止目标应用，重新打开才会生效，部分情况需要重启。

实践中的原则是“最小作用域”：只勾选确实需要修改的应用，不要图省事全选。出问题时，小作用域也更容易通过取消勾选来定位。

常见模块类型

LSPosed 生态里的模块大致可以分为几类：

• 界面定制：修改特定应用的布局、主题、去广告、去除推广入口。
• 功能增强：为应用补充官方没有提供的能力，例如批量操作、快捷入口。
• 数据与备份：读取或导出应用内部数据，对目标应用的版本很敏感。
• 系统界面调整：修改状态栏、通知样式、导航方式，影响范围较大。
• 应用兼容性修复：让旧应用在新系统上正常运行，通常只对单个应用生效。

装模块前先看它声明支持的应用版本。应用更新后类名和方法签名会变化，模块很可能直接失效，甚至让目标应用闪退。

模块不生效怎么排查

按下面顺序检查，通常能定位大部分问题：

1. 框架是否激活。管理器状态页应显示正常的框架版本和激活状态。
2. Zygisk 是否开启。关闭后框架失去注入环境，所有模块都会失效。
3. 模块是否启用。装完模块后需要在管理器里手动打开开关。
4. 作用域是否勾选。最常见的疏漏就是装了模块却没勾选目标应用。
5. 目标应用是否重启。修改作用域或更新模块后，强制停止应用再打开。
6. 模块与应用版本是否匹配。查看模块说明里的支持范围，必要时降级应用。
7. 是否有冲突模块。禁用其他模块后单独测试。
8. 查看日志。管理器内通常有日志入口，能看到模块加载失败的具体原因。

如果日志显示模块已加载但功能无效，问题多半在模块本身与应用版本的适配，而不是框架。此时不要反复重装框架，换模块版本或等待更新更有效。

关于隐藏 Root 的讨论

不少应用会检测设备是否被修改，检测手段包括检查 Root 痕迹、框架特征、系统属性完整性等。社区里长期存在关于如何降低检测率的讨论，涉及专门的隐藏模块和配置技巧。

这里只说明几点事实，不提供具体绕过手法：

• 检测与隐藏是持续对抗的过程，任何方案都可能随应用更新失效。
• 使用隐藏手段可能违反部分应用的用户协议，存在账号受限的风险。
• 修改系统完整性相关分区会影响系统更新和部分安全功能，操作前要清楚代价。
• 金融、支付类应用对环境的敏感度最高，不建议在这类设备上承担额外风险。

如果某台手机需要长期运行对 Root 敏感的应用，更稳妥的选择是保持系统原样，把折腾放在备用设备上。

常见问题

LSPosed 和 Xposed 能同时装吗？

不建议。两者修改运行时的方式不同，同时存在容易冲突，且现代系统上旧框架的兼容性很差。选择其中一个即可。

装完框架后桌面没有图标怎么办？

部分版本默认隐藏入口，需要通过通知、拨号指令或 Magisk 模块页面的说明进入。先看发布说明里的启动方式，不要急着重刷。

模块勾选了应用还是没效果？

优先确认应用是否被强制停止后重新启动，再核对模块支持的应用版本。若日志里没有该模块的加载记录，说明作用域或框架状态有问题。

系统更新后框架失效正常吗？

正常。系统更新会替换运行时环境，框架需要重新适配。更新前建议禁用模块，更新后等待框架发布兼容版本，再重新安装。

框架会影响手机性能和续航吗？

框架本身开销很小，真正的负担来自具体模块。模块越多、作用域越广，额外的内存占用和耗电越明显。只保留必要的模块是控制影响的最好办法。