米侠浏览器外部JS库本地路径配置方法

米侠浏览器要加载本地JS库，其实并不复杂，只需要搞定四个关键点：启用暴力猴并打开“在所有网站上运行”和“允许访问文件网址”权限；把库文件放进 /sdcard/MiXiaBrowser/scripts/ 这个路径；在脚本里用 @require ./xxx.js 声明依赖；最后重启浏览器，再刷新一下脚本列表。这几个步骤缺一不可，但很多人往往卡在细节上。

为什么会这么麻烦？因为米侠浏览器加载外部JS库时，如果依赖的是本地文件（比如 jQuery、Lodash 或者你自己封装的一些工具函数），就必须把它放在浏览器能认出来的固定路径下。否则，即使你在脚本里写了 ，也会因为 Chromium 对 file:// 协议的限制而悄悄失败，连个错误提示都没有。

确认脚本管理器是否已启用并授予权限

外部JS库是通过脚本管理器（也就是暴力猴）注入到页面里的，不是直接用网页的 script 标签加载。所以第一步，得先确保暴力猴扩展已经开启，而且权限给够了。操作很简单：点击右上角扩展图标，右键“暴力猴”，选择“管理扩展”，然后把【在所有网站上运行】和【允许访问文件网址】这两个开关都打开。

回到暴力猴界面，左上角菜单里找到“设置”→“通用”，确认【启用脚本】已经处于打开状态。这一步没做完，后面所有 @require 声明都是白搭。

将JS库文件放入米侠浏览器指定扫描路径

在安卓设备上，米侠浏览器只会自动扫描一个路径里的 .js 文件：/sdcard/MiXiaBrowser/scripts/。其他位置，比如 /sdcard/Download/、/sdcard/lib/ 甚至根目录，它根本不会理会。哪怕你把路径写得再正确，只要文件没放在这个文件夹里，@require 就会加载失败。

所以，用手机文件管理器新建这个路径：/sdcard/MiXiaBrowser/scripts/（注意大小写和斜杠方向，千万不能写成 Mixia 或者 mixiabrowser）。然后把 jquery.min.js、lodash.4.17.21.js 这些库文件复制进去。

如果这个文件夹已经存在，但库文件似乎没生效怎么办？重启浏览器，进入【设置→高级设置→脚本注入】页面，点击右上角的【刷新脚本列表】按钮——这一步千万不能跳过，否则浏览器不会重新读取磁盘上的文件。

在用户脚本中正确声明本地库路径

方法一：使用 @require 指向 scripts 目录内的相对路径

在脚本头部注释区直接添加：
@require ./jquery.min.js
@require ./lodash.4.17.21.js
注意：路径必须以 ./ 开头，不能写成 file:///sdcard/... 或 /sdcard/...，也不能省略扩展名 .js。

方法二：在脚本正文内动态加载（适用于条件加载或调试）

执行下面这段代码前，先确保库文件已经在 scripts 目录里：
const script = document.createElement('script');
script.src = 'file:///sdcard/MiXiaBrowser/scripts/jquery.min.js';
document.head.appendChild(script);
这种方式会绕过脚本管理器的校验，但受 file:// 协议限制，部分 API（比如 fetch、localStorage）可能还是用不了。

方法三：改用 CDN（推荐用于开发调试）

如果本地路径反复失败，可以临时换成：
@require https://cdn.jsdelivr.net/npm/jquery@3.7.1/dist/jquery.min.js
先确认逻辑没问题，再切回本地路径，这样能避免误判成代码的锅。

验证库是否成功加载

第一步，在目标网页上打开控制台（菜单→检查元素→Console）。第二步，输入 $ 或 jQuery（如果你引入的是 jQuery），按回车。如果返回的是函数定义，而不是 undefined，说明加载成功。第三步，如果报错 ReferenceError: $ is not defined，就回头检查：scripts 目录文件是否存在、扩展权限是否开启、脚本是否启用、@require 行有没有拼写错误。

还有一个容易忽略的点：如果你的脚本匹配的是 file:// 协议页面（比如本地 HTML 文件），那必须在 @match 里加上 @match file://*，否则脚本根本不会运行，自然也没法加载任何 @require。