米侠浏览器脚本加载失败需依次检查:①开启“启用脚本注入”开关;②确保.js文件为小写扩展名、UTF-8无BOM编码、独立解压存放;③放入/sdcard/MiXiaBrowser/scripts/路径并刷新脚本列表;④切换内核与UA组合;⑤关闭阅读模式和文本重排后强制刷新。

米侠浏览器脚本加载失败时,页面行为常表现为功能按钮无响应、自定义UI未出现、控制台无报错但逻辑缺失,这类问题多由注入开关关闭、路径格式错误或匹配规则失效直接导致,不是所有脚本都能“放进去就跑”。
确认脚本注入总开关已开启
米侠v5.5.4起将脚本注入设为手动开关,默认关闭,不开启则所有脚本静默失效。【必须先做这一步】
点击右上角三个点→【设置】→【高级设置】→【脚本注入】→将“启用脚本注入”切换为开启状态。
重启浏览器后,再进入该页面确认开关右侧显示“已启用”,否则后续操作全部无效。
验证脚本文件是否符合准入条件
米侠浏览器对本地脚本有硬性校验:只认纯小写 .js 扩展名、UTF-8无BOM编码、解压后独立存放于指定目录——三者缺一不可。
第一步:检查文件扩展名是否为 .js —— 若是 .JS、.Js 或带空格(如“my script.js”),浏览器会静默忽略,不报错也不显示。
第二步:用文件管理器长按该.js文件→「编辑」→全选粘贴到记事本类纯文本工具中查看:若开头出现乱码或隐藏BOM头(如 EF BB BF 字节),必须另存为UTF-8无BOM格式,否则解析失败。
第三步:确认脚本未被压缩包包裹——米侠不支持直接读取.zip/.rar内嵌的.js,必须解压到目录层级中,且若有 manifest.json,需与.js同级。
将脚本放入浏览器可识别的固定路径
安卓设备上,米侠浏览器仅扫描以下路径中的.js文件:【/sdcard/MiXiaBrowser/scripts/】。其他任何位置(如Download、Documents、根目录)均不会被自动发现。
操作很简单:用文件管理器新建文件夹,路径必须严格为 /sdcard/MiXiaBrowser/scripts/(注意大小写和斜杠方向),然后把你的.js文件复制进去。
若该路径已存在但脚本仍未出现,重启浏览器后进入「设置→高级设置→脚本注入」页,点击右上角「刷新脚本列表」按钮——这一步不能跳过,否则浏览器不会重新扫描磁盘。
强制切换内核+UA组合绕过兼容性陷阱
某些金融类或视频平台网页在X5内核下会彻底禁用脚本注入,此时必须用系统内核+iPhone UA才能触发完整DOM加载,脚本才有执行基础。
方法一:X5内核 + 桌面版UA
① 进入【设置】→【高级设置】→【内核与UA设置】
② 将内核切换为【X5内核】,UA同步设为【桌面版】
③ 重启浏览器→测试脚本
方法二:系统内核 + iPhone UA
若方法一失败,切回【系统内核】+【iPhone UA】→重启→重试
关闭阅读模式与文本重排
这两项功能会主动重构页面DOM结构,把原始HTML撕碎重排,油猴脚本依赖的元素选择器全部失效。
在任意网页点右下角三个点→【设置】→【网页浏览设置】→关闭【自动重排文本】和【阅读模式】
关闭后必须点击地址栏右侧刷新按钮强制重载,仅切换开关不刷新等于没关。











