米侠浏览器v5.5油猴脚本失效需分步排查：先开启“启用脚本注入”开关；再检查脚本路径与utf-8无bom格式；接着尝试x5内核+桌面ua、系统内核+iphone ua两种组合；关闭阅读模式与文本重排并强制刷新；最后重置注入配置重新导入脚本。
米侠浏览器v5.5版本中油猴脚本无法注入、启用后不运行或直接报错，常见于脚本匹配失效、注入开关未开、X5内核与脚本执行时机冲突等具体环节，需按实际异常现象分路径排查。
确认脚本注入总开关已开启
米侠v5.5.4起将脚本注入设为手动开关，默认关闭，不开启则所有脚本静默失效。【必须先做这一步】
点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。
重启浏览器后，再进入该页面确认开关右侧显示“已启用”，否则后续操作全部无效。
检查脚本存放路径与文件格式
方法一：本地.js脚本必须放对位置且无BOM头
将脚本文件保存为UTF-8无BOM编码的纯文本，扩展名严格为.js；Android用户存入/sdcard/MiXiaBrowser/scripts/，macOS用户存入~/Library/Application Support/MiXiaBrowser/scripts/。
方法二：在线脚本需手动刷新扫描
开启注入开关后，返回【脚本注入】页，点击右上角【刷新脚本列表】，等待几秒——若脚本仍不出现，说明路径错误或文件被系统拦截（如iOS/iPadOS因沙盒限制根本无法访问该目录）。
强制切换内核+UA组合绕过兼容性陷阱
第一步：进入【设置】→【高级设置】→【内核与UA设置】
第二步：先将内核切换为【X5内核】，UA同步设为【桌面版】→重启浏览器→测试脚本
第三步：若失败，再切回【系统内核】+【iPhone UA】→重启→重试
X5内核对国内网站适配好但会屏蔽部分现代API，系统内核更接近Chrome行为但默认UA可能被识别为低端安卓设备导致服务器返回阉割版HTML——两种组合必须都试，不能只试一种。
注意：某些金融类或视频平台网页在X5内核下会彻底禁用脚本注入，此时必须用系统内核+iPhone UA才能触发完整DOM加载，脚本才有执行基础。
关闭阅读模式与文本重排
这两项功能会主动重构页面DOM结构，把原始HTML撕碎重排，油猴脚本依赖的元素选择器全部失效。
在任意网页点右下角三个点→【设置】→【网页浏览设置】→关闭【自动重排文本】和【阅读模式】
关闭后必须点击地址栏右侧刷新按钮强制重载，仅切换开关不刷新等于没关。
重置注入配置并重新导入脚本
① 进入【脚本注入】设置页→点击右上角【更多】→【导出配置】（可选，用于备份）
② 选择【重置脚本注入设置】→确认清除全部规则与启用状态
③ 重启浏览器→重新进入【脚本注入】页→点击【刷新脚本列表】→逐个勾选启用目标脚本
重置会清空所有匹配规则，但能排除v5.5.3升级到v5.5.4时因配置项字段变更导致的解析异常——这是很多用户跳过却最有效的兜底操作。
