米侠浏览器脚本异常需按四步排查：①确认脚本注入总开关已启用并重启验证；②修正@run-at为document-end并补全@require依赖；③切换系统内核、关闭自动重排与阅读模式、清除缓存；④关闭广告过滤、重置暴力猴、清除网站数据及开发者工具中全部存储。
米侠浏览器脚本功能开启后网页出现按钮失灵、布局错位、文字重复、图片不显示或页面白屏等异常，不是脚本本身写错了，而是注入机制与页面渲染链发生了冲突——总开关虽开，但脚本执行时机、内核兼容性、DOM劫持权限或样式重排策略未同步适配，必须按污染层级逐项隔离验证。
确认脚本注入总开关已启用且持久生效
点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。【必须先做这一步】
重启浏览器后，返回该设置页，确认开关右侧明确显示“已启用”。若仍显示“关闭”或开关灰显，说明当前版本低于v5.5.4.2，需卸载后重装官网“脚本版”安装包。
检查脚本执行时机是否触发DOM竞争
旧脚本常设 @run-at document-start 或未声明 @run-at，而米侠v5.5+默认在 DOMContentLoaded 后才稳定注入，过早执行会导致 document.body 为 null、querySelector 返回空、样式表未加载就操作节点。
打开脚本编辑页，在元数据头部添加或修正：@run-at document-end
若脚本依赖 jQuery 或其他全局库，必须同时补上：@require https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js（注意用 HTTPS 协议）；否则直接报 $ is not defined，后续所有 DOM 操作全部中断。
切换内核并关闭干扰渲染功能
米侠默认 X5 内核对 MutationObserver、Shadow DOM 和 CSS 自定义属性支持薄弱，脚本动态插入元素后极易引发样式丢失或回流失败。
第一步：在问题网页地址栏左侧长按锁形图标→选择“切换内核”→选“系统内核”→等待自动刷新。
第二步：进入【设置】→【浏览设置】→关闭“自动重排文本”和“阅读模式”。这两项会在脚本修改 DOM 后强行二次解析 HTML，覆盖脚本注入的 class 和 style 属性，导致按钮恢复默认样式、折叠菜单无法展开。
第三步：返回该网页，长按地址栏右侧刷新按钮→选择“清除缓存后重新加载”。仅普通刷新无法清掉内核层的样式缓存，错位会持续存在。
禁用广告拦截与自定义脚本叠加干扰
广告过滤规则（如 ##.btn-primary）和暴力猴自定义脚本可能同时操作同一类名，前者删除节点，后者又试图插入，最终页面结构断裂。
方法一：点击右下角三横线菜单→【设置】→【隐私与安全】→关闭“广告过滤”和“增强版通用广告过滤”。
方法二：在同一设置页向下滚动→进入“自定义规则”→【删除所有含##、||、domain=语法的条目】。哪怕只留一条，也会持续生效并与其他脚本产生不可预测冲突。
方法三：点击暴力猴图标→左上角菜单→设置→通用→关闭【启用脚本】→等待 3 秒→再开启。这能强制重置其内部执行队列，避免旧任务残留卡死新注入流程。
清除网站数据并重建脚本执行环境
脚本首次运行时生成的 localStorage 数据、Service Worker 缓存或 IndexedDB 表结构，可能与新版脚本逻辑不兼容，导致反复执行错误分支。
① 进入【设置】→【隐私与安全】→【清除浏览数据】→勾选【网站数据】+【缓存文件】→点击“清除”。
② 在异常网页地址栏右侧点击米侠图标→选择“当前页设置”→将“JavaScript”“Cookie及其他网站数据”“不安全内容”全部设为“允许”。
③ 地址栏输入 mi://devtools#application → 回车→在 Application 面板中，手动删除左侧 Storage 下所有项目（Local Storage、Session Storage、IndexedDB、Cache Storage），然后关闭开发者工具并刷新页面。
