修补参数详解:哪些该开哪些别动
参数面板位置
选完目标应用后会进入修补配置页。常见的参数项如下。

注入文件提供者(推荐开启)
作用:配合 MT 管理器之类的工具,让 LSPatch 在修补时从指定路径读取模块 dex 文件,而不是从已安装的模块里读。
什么时候开:
- 你有一个模块的 APK 文件但还没安装到手机上,想直接嵌入
- 模块已经装了但想换一个版本的 dex
- 第三方魔改版默认就开着,保持默认即可
什么时候关:
- 从已安装模块里直接选(便携模式)或动态加载(本地模式)时不需要
- 原版 LSPatch 这个选项的默认行为取决于版本,opatch/onpatch 一般默认开着
建议:保持默认。不确定含义就别动它。
输出日志到目录(默认关闭)
作用:修补过程中把详细的调试日志写到修补输出目录。
什么时候开:
- 修补失败了,需要排查问题时开一次拿日志反馈
- 开发模块时需要看加载器的详细输出
什么时候关:日常修补不需要,日志文件占空间也没意义。
建议:默认关闭,出问题时临时开。
覆写版本号(按需开启)
作用:强制把修补后 APK 的 versionName 和 versionCode 改成你输入的值。
什么时候开:
- 某些模块对宿主应用版本号有硬编码要求(比如只认微信 8.0.43 以上),可以把修补后的版本号改成符合要求的值
- 降级场景:想让模块以为宿主是某个老版本
什么时候别开:日常修补别碰。覆写版本号后,应用商店会一直提示"有更新可用"——因为商店看到的版本号和覆写后的对不上,强迫症可能会被逼疯。
建议:99% 的情况别动。
去签模式/签名覆盖模式
不同版本叫法不同,opatch 里叫"去签模式"。
作用:处理应用自带的 V2/V3/V4 签名。某些加固应用或自定义签名的应用,修补后签名校验会因为原签名残留而失败。
选项:
- 自动覆盖(默认):LSPatch 生成新签名,直接替换原签名块
- 先清除再签名:彻底移除原签名块再加新签名,某些加固应用需要这个
- 保留原签名:极少数场景,基本用不到
建议:默认自动覆盖。如果修补后闪退或签名报错,回来换"先清除再签名"试试。
本地模式 vs 便携模式
这个是最关键的选择,面板里通常在顶部或中部有切换 Tab。详细对比见 本地 vs 便携模式的取舍。选完模式后:
- 本地模式:不需要选模块,运行时由管理器动态加载
- 便携模式:点「嵌入模块」按钮,选择要嵌入的模块
修补按钮
参数都调好后,点右下角的对勾或「开始注入」。修补过程会显示进度条,通常几秒到几十秒(APK 越大越慢)。修补完成后会提示输出路径。
如果 Shizuku 已连接,会自动调用 pm install 尝试安装修补好的 APK——这时候手机上如果还装着原版,会报签名不匹配错误(正常),手动先卸载原版再点安装即可。