米侠浏览器用户脚本不生效主因是url未被@match规则覆盖，需检查启用状态、匹配规则（含file://需显式声明）、注入总开关、内核与ua设置、脚本路径编码（utf-8无bom）、阅读模式及冲突扩展。
米侠浏览器安装的用户脚本在部分网页不生效，不是脚本写错了，而是当前页面URL未被脚本的匹配规则覆盖——脚本根本没被加载进页面，不会报错、不弹提示、也不执行任何代码，静默跳过。
确认脚本是否已启用且匹配当前页面
点击右上角扩展图标 → 选择「米侠脚本管理器」→ 在列表中找到目标脚本，检查右侧开关是否为绿色开启状态。
点击该脚本右侧「编辑」按钮 → 拉到代码顶部注释区 → 查看是否存在 @match 或 @include 行；若不存在，脚本默认不匹配任何页面。
打开你要运行脚本的目标网页（例如 https://github.com/username/repo），再回到编辑页 → 对照当前地址栏完整URL，确认 @match 规则是否精确覆盖：比如 @match https://github.com/* 才能匹配，而 @match github.com/* 或 @match *github* 都无效。
【必须注意】 若当前页面是本地 HTML 文件（地址以 file:// 开头），脚本头部必须显式添加 @match file://*，否则绝对不触发——这是安全策略，无法绕过。
检查浏览器级注入总开关与内核兼容性
点击右上角三个点 → 【设置】→ 【高级设置】→ 【脚本注入】→ 确保“启用脚本注入”已开启，并确认重启浏览器后该开关显示“已启用”。
若开关缺失或无法开启，请立即在地址栏输入 about:version 回车 → 查看版本号末尾是否含 UM 或 UserScript 字样；没有则说明你安装的是普通版，【必须卸载后前往官网下载带‘脚本版’标识的安装包重装】。
打开目标网页后，长按地址栏左侧锁形图标 → 弹出菜单中选择“切换内核” → 先试“X5内核”，再试“系统内核”，观察脚本是否恢复运行；X5内核对国内网站兼容更好，但部分国际站需同步切换UA为桌面版才可正确匹配。
验证脚本路径、编码与文件格式
方法一：安卓设备请用文件管理器进入 /sdcard/MiXiaBrowser/scripts/ 目录 → 确认脚本文件存在且扩展名是纯小写 .js（不能是 .JS、.user.js 或带空格）。
方法二：长按脚本文件 → 「编辑」→ 全选内容粘贴至记事本类纯文本工具 → 若开头出现乱码或隐藏字符（如 ），说明文件含 BOM 头 → 必须另存为 UTF-8 无 BOM 格式，否则米侠解析失败且不报错。
⚠️注意：路径中含中文、全角符号、大小写错误（如 MixiaBrowser 写成 mixiabrowser）都会导致文件被完全忽略。
排查阅读模式、文本重排与冲突扩展
第一步：在目标网页点击右上角三个点 → 关闭「阅读模式」和「文本重排」两项开关 → 刷新页面。
第二步：在地址栏输入 miex://extensions 回车 → 进入扩展管理页 → 临时停用所有广告拦截类、隐私保护类、视频增强类扩展 → 刷新目标网页测试。
第三步：若恢复生效，逐个启用扩展并刷新，定位具体冲突项；确认后点击其右侧「删除」彻底卸载，避免残留权限干扰脚本 DOM 操作。
