当米侠浏览器里的网页 JavaScript 突然罢工，页面按钮点不动，动态内容一片空白，表单提交毫无反应，甚至控制台直接甩出“ReferenceError: xxx is not defined”。

别急着怀疑脚本写错了。这类问题十有八九是脚本注入开关没开、内核兼容性不对、权限没给到位或者缓存捣乱，而不是所有 JS 都能自动跑起来。

以下几个步骤，按顺序排查，基本能解决九成以上的 JS 执行问题。

确认 JavaScript 全局开关已启用

米侠从 v5.5.4 版本开始，把 JavaScript 变成了可手动关闭的选项。默认是开启的，但很容易被误操作关掉。所以第一步先检查这个全局开关。

操作步骤：

• 点右上角三个点 → 【设置】 → 【网站设置】 → 【JavaScript】
• 确保开关是开启状态。如果右侧显示“已禁用”，请立即打开，然后重启浏览器。

否则后面所有 JS 都不会被解析执行，白忙活。

检查脚本注入总开关是否激活

全局 JS 开了，不意味着自定义脚本（比如油猴类的用户脚本）就能跑。脚本注入这个总开关默认是关闭的。不开的话，你放进去的任何 .js 文件都会被静默忽略，连个提示都没有。

操作：

• 点右上角三个点 → 【设置】 → 【高级设置】 → 【脚本注入】
• 把“启用脚本注入”打开。重启浏览器后，再回到这个页面确认右侧显示的是“已启用”。

否则后续脚本文件根本进不了扫描队列。

验证脚本文件是否符合硬性准入条件

米侠对本地脚本的要求很严格：扩展名必须是小写 .js、编码必须是 UTF-8 无 BOM、文件必须解压后放在指定目录。三条缺一不可，少一条就静默忽略。

先看扩展名：必须是全小写的 .js。如果是 .JS、.Js，或者文件名里带空格（比如“my script.js”），浏览器直接无视，不报错不显示。

再看编码：用文件管理器长按那个 .js 文件 → 选择「编辑」→ 全选复制到记事本之类的纯文本工具里查看。如果开头出现乱码或隐藏 BOM 头（比如 EF BB BF 这些字节），那就必须另存为 UTF-8 无 BOM 格式，否则解析失败。

最后确认文件没有被压缩包包裹。米侠不支持直接读取 .zip 或 .rar 里的 .js，必须解压出来。如果脚本包里还带一个 manifest.json，那就让 manifest.json 和 .js 文件放在同一层目录下。

将脚本放入浏览器唯一识别路径

安卓设备上，米侠只认一个位置的 .js 文件：/sdcard/MiXiaBrowser/scripts/。放 Download 文件夹、Documents 文件夹、或者根目录？浏览器根本不去看。

操作很简单：

• 用文件管理器新建文件夹，路径必须严格写成 /sdcard/MiXiaBrowser/scripts/（大小写和斜杠方向都不能错）。
• 然后把你的 .js 文件复制进去。
• 如果这个路径已经存在但脚本还是没出现，重启浏览器后进入【设置 → 高级设置 → 脚本注入】页面，点右上角的「刷新脚本列表」按钮。这步不能跳过，否则浏览器不会重新扫描磁盘。

强制切换内核+UA组合触发JS完整执行

有些金融类或视频平台网页，在 X5 内核下会主动屏蔽第三方脚本注入。这时候必须换成系统 WebView 内核，再配合 iPhone UA，DOM 才能完整加载，JS 才有执行的基础。

有两种常见组合：

方法一：X5内核 + 桌面版UA

• 进入【设置】→【高级设置】→【内核与UA设置】
• 把内核切换为【X5内核】，UA同步设为“桌面版”

方法二：系统内核 + iPhone UA（适用于X5失效的场景）

• 同样进【内核与UA设置】
• 内核切回“系统WebView”，UA设为“iPhone”
• 保存并重启浏览器，然后再访问目标网页。

两种组合都试试，总有一款能让 JS 乖乖跑起来。

《夸克》非常好用的免费AI浏览器

下载APP查看