米侠浏览器管理已安装用户脚本版本的教程

时间：2026-06-25 | 作者：318050 | 阅读：0

在米侠浏览器里玩User Script时，版本管理经常踩坑。明明下载了两个版本，脚本管理器列表里却只显示一个条目。想对比测试或安全卸载，总得折腾半天。

问题出在米侠对脚本版本识别的逻辑上：它完全依赖文件名、元数据块中的@version字段，再加上本地存储哈希值。三者必须完全匹配，只要有一项对不上，就会被当作全新脚本处理。换句话说，手动管理版本比想象中要讲究得多。

举个具体场景：你想区分“知乎免登录下载 v1.2”和“v1.3-beta”，甚至并行启用它们做对比测试。但暴力猴列表里只有一个名称，根本分不清哪个是哪个。这可不是界面bug，而是底层识别机制决定的。所以，搞清楚当前已安装脚本的真实版本信息，是第一步。

识别当前已安装脚本的真实版本信息

进入暴力猴主界面，点左上角菜单，选“脚本列表”。找到目标脚本后点右侧的编辑图标。滚动到脚本头部元数据区（// ==UserScript==开始那一段），找到@version那一行。

注意：这行必须是纯数字或语义化版本号，比如1.3.0。如果写成空值、带空格或“最新版”，暴力猴会一律视为v0.0.0，后续版本比对直接失效——这是最容易忽略的细节。

想确认文件本身的信息，右滑脚本条目，点“详情”，能看到“最后修改时间”和“文件路径”。Android设备的默认路径是/sdcard/MiXiaBrowser/scripts/xxx.user.js，macOS则是~/Library/Application Support/MiXiaBrowser/scripts/xxx.user.js。

路径末尾的文件名如果带着版本号（比如zhihu-dl-v1.2.user.js），说明你之前手动重命名过。如果是一串随机哈希（比如a3f9d2e8.user.js），那这个脚本很可能是通过导入或新建生成的，原始版本信息已经丢了，只能靠元数据里的@version来识别。

并行安装多个版本脚本（用于对比测试）

方法一：改名+改@version+独立存放

把v1.2的脚本文件复制一份，重命名为zhihu-dl-v1.2.user.js。然后用Acode之类的文本编辑器打开，把头部@version改成1.2.0，保存为UTF-8无BOM格式。放入/sdcard/MiXiaBrowser/scripts/目录。

同样的步骤处理v1.3的脚本，命名为zhihu-dl-v1.3.user.js，@version改成1.3.0。重启米侠浏览器，打开暴力猴，左上角菜单选“重新扫描脚本”。两个版本会分别出现在列表中，名称默认取自@name字段。

提示：你可以在列表里右滑条目，选“重命名”，给每个版本加上版本后缀（比如“知乎免登录下载 v1.2”），方便区分。

注意：两个版本的@match规则必须完全一致，否则可能只触发其中一个。如果想把v1.3当成测试版隔离，可以临时把它的@match改成https://www.zhihu.com/test/*，避免干扰正式环境。

方法二：同一文件内用条件分支模拟多版本

如果不想管理多个文件，可以在单个脚本代码末尾加一段逻辑：

if (GM_info.script.version === '1.2.0') { /* v1.2 特有逻辑 */ } else if (GM_info.script.version === '1.3.0') { /* v1.3 特有逻辑 */ }

这样只需要一个文件，调试时不用来回切换。但缺点也很明显：无法单独启用或停用某个版本，而且@version必须跟元数据块严格一致，否则GM_info.script.version会返回undefined，分支逻辑直接失效。

安全卸载旧版本并保留新版本配置

第一步：确认新版本正常。打开目标网页，检查功能是否生效。再看暴力猴控制台日志（右键页面选“检查”，切到Console标签页）有没有报错。确认没问题后，再处理旧版。
第二步：停用并备份旧版本。在暴力猴脚本列表里找到旧版本条目，把右侧开关关掉。然后右滑，选择“导出脚本”，保存为backup-v1.2.js，留个回滚备份。
第三步：彻底移除旧版本。回到脚本列表，长按旧版本条目，点“删除”，在弹窗里点“确定”。注意：删除操作不可逆，而且不会自动清理/sdcard/MiXiaBrowser/scripts/目录下对应的.user.js文件。如果那个文件还在，下次扫描时系统会重新加载它，变成一个新条目。
第四步：手动清理残留文件。用文件管理器进/sdcard/MiXiaBrowser/scripts/目录，找到旧版本对应的文件（比如zhihu-dl-v1.2.user.js），长按，选“删除”。这一步不能省。