米侠浏览器脚本添加后不运行解决方法

实际上，米侠浏览器的脚本功能操作起来确实有些复杂——即便已将脚本文件放入scripts文件夹，暴力猴也安装完毕，但打开目标网页后，脚本依然无法执行。问题并非出在脚本本身，而是浏览器未能识别或注入该脚本。从底层开关到匹配规则，每个环节都需要逐一排查。

以下提供详细排查步骤，建议按顺序操作，跳过任何一步都可能导致问题无法解决。

确认浏览器是否具备脚本运行基础

打开地址栏，输入【about:version】→ 查看版本号末尾是否有“UM”或“UserScript”字样。如果没有，说明当前安装包不支持脚本功能，【必须卸载后前往官网下载带‘脚本版’标识的安装包重装】。

重启浏览器后，在地址栏输入【miscript://】，若能正常打开脚本管理页面，则表示基础支持已就绪。

开启浏览器级脚本注入总开关

点击右上角三个点图标 → 进入【设置】→【高级设置】→ 找到【脚本注入】选项 → 将开关设为开启状态。

【若该选项缺失，说明当前版本低于 v5.5.4.2，必须升级】。关闭浏览器后再重新打开，确保设置生效——此步骤若不执行，后续所有操作均无效。

检查暴力猴是否真正启用并授权

方法一：通过扩展面板授予权限
点击右上角扩展图标 → 找到“暴力猴” → 右键选择“管理扩展” → 开启【在所有网站上运行】和【允许访问文件网址】两项权限。

方法二：进入暴力猴内部确认启用
点击暴力猴图标打开主界面 → 左上角菜单 → 设置 → 通用 → 确保【启用脚本】开关为开启状态。此步骤常被忽略，但它是暴力猴自身是否响应的总闸。

验证脚本文件是否被浏览器识别

第一步：确认路径是否严格为【/sdcard/MiXiaBrowser/scripts/】（安卓）或【~/Library/Application Support/MiXiaBrowser/scripts/】（macOS），注意大小写与斜杠方向。

第二步：检查文件扩展名是否为纯小写 .user.js —— 若是 .USER.JS、.js.txt 或包含空格（如“签到脚本.user.js”），浏览器会静默忽略，既不报错也不显示。

第三步：用记事本打开该文件 → 全选复制 → 粘贴到Notepad++或VS Code中 → 查看开头是否有乱码或隐藏BOM头（如 ）→ 【务必另存为UTF-8无BOM格式】。

修复脚本匹配与执行时机

第一步：关闭所有已打开的目标网站标签页
第二步：新建标签页 → 手动输入网址（如 https://bilibili.com）→ 等待页面完全加载完毕
第三步：点击地址栏左侧「脚本状态图标」→ 查看日志中是否出现「 已激活|执行成功 x1」字样

第四步：若无日志或显示「 匹配失败」，返回暴力猴编辑脚本 → 检查@match规则是否与当前URL完全一致。例如页面是 https://www.zhihu.com/question/123，而规则写的是 @match https://zhihu.com/*，则会因子域名不匹配而失效。

第五步：确认元数据块中包含 @run-at document-end —— 若漏掉这一行，脚本大概率因元素未就绪而静默失败。