米侠浏览器脚本失效需依次排查：确认安装“脚本版”包（about:version含UM或UserScript）、开启注入总开关（v5.5.4.2+）、脚本路径格式正确（UTF-8无BOM、.js小写）、@match精确匹配URL并加@run-at document-end、关闭阅读模式与文本重排、尝试X5/系统内核+不同UA组合。
米侠浏览器安装脚本后网页端无任何反应，不是脚本逻辑错了，而是脚本根本没被加载进页面——从底层开关到匹配规则，任一环节缺失都会导致静默失效，且不报错、不提示、不弹窗。
确认浏览器是否具备脚本运行基础
在地址栏输入 【about:version】 → 查看版本号末尾是否带有【UM】或“UserScript”字样。没有则说明当前安装包不支持脚本功能，【必须卸载后前往官网下载带‘脚本版’标识的安装包重装】。
重启浏览器后，在地址栏输入 【miscript://】，能正常打开脚本管理页才算基础就位。旧版本即使开启所有开关也无法调用 DOM 接口，且不报错。
开启浏览器级脚本注入总开关
点击右上角三个点图标 → 进入【设置】→ 【高级设置】→ 向下滚动找到【脚本注入】选项 → 将“启用脚本注入”开关切换为开启状态。
若该选项缺失，请立即检查版本号：必须为 v5.5.4.2 及以上，旧版本不提供此开关，也无法通过设置补救。关闭浏览器再重新打开，确保设置生效——这一步不做，后面所有操作全部无效。
验证脚本存放路径与文件格式
方法一：本地 .js 脚本必须放对位置且无 BOM 头
将脚本文件保存为 UTF-8 无 BOM 编码的纯文本，扩展名严格为 【.js】（小写，不能是 .JS 或 .user.js）；Android 用户存入 【/sdcard/MiXiaBrowser/scripts/】，macOS 用户存入 【~/Library/Application Support/MiXiaBrowser/scripts/】。
⚠️注意：文件必须为 UTF-8 无 BOM 格式，否则解析失败；用记事本另存为“UTF-8(无签名)”最稳妥。若路径中含中文、空格或大小写错误（如 MixiaBrowser 写成 mixiabrowser），浏览器会直接忽略该文件。
方法二：在线脚本需手动刷新扫描
开启注入开关后，返回【脚本注入】页，点击右上角【刷新脚本列表】，等待几秒——若脚本仍不出现，说明路径错误或文件被系统拦截（如 iOS/iPadOS 因沙盒限制无法访问该目录）。
检查脚本匹配规则与执行时机
第一步：确认 @match 规则精确覆盖目标网页 URL
例如目标页是 https://www.bilibili.com/video/BV1xx411c7mD，脚本中必须包含 @match *://*.bilibili.com/* 或更具体的 @match *://www.bilibili.com/video/*。若只写 @match https://bilibili.com/*，则完全不匹配。
第二步：强制指定执行时机为 document-end
在脚本头部添加 【@run-at document-end】。不加此行时，米侠默认使用 document-idle，但部分页面 DOM 加载节奏异常，会导致脚本在 body 尚未生成时就执行完毕，看似运行了实则什么都没操作。
第三步：若脚本需操作 file:// 协议页面（如本地 HTML 文件），必须额外添加 @match file:///*，否则绝对不触发。
关闭阅读模式与文本重排
在任意网页点右下角三个点 → 【设置】→ 【网页浏览设置】→ 关闭【自动重排文本】和【阅读模式】。
关闭后必须点击地址栏右侧刷新按钮强制重载，仅切换开关不刷新等于没关。这两项功能会主动重构页面 DOM 结构，把原始 HTML 撕碎重排，脚本依赖的元素选择器全部失效。
强制切换内核+UA 组合绕过兼容性陷阱
① 进入【设置】→【高级设置】→【内核与UA设置】
② 先将内核切换为【X5内核】，UA 同步设为【桌面版】→ 重启浏览器 → 测试脚本
③ 若失败，再切回【系统内核】+【iPhone UA】→ 重启 → 重试
X5 内核对国内网站适配好但会屏蔽部分现代 API，系统内核更接近 Chrome 行为但默认 UA 可能被识别为低端安卓设备导致服务器返回阉割版 HTML——两种组合必须都试，不能只试一种。某些金融类或视频平台网页在 X5 内核下会彻底禁用脚本注入，此时必须用系统内核+iPhone UA 才能触发完整 DOM 加载，脚本才有执行基础。
