米侠浏览器脚本执行顺序冲突该如何手动调整优先级？

油猴脚本在米侠浏览器里跑得好好的，怎么一多个脚本同时触发就出乱子了？这其实就是典型的执行顺序冲突——脚本之间掐架，导致功能覆盖、DOM劫持失败甚至变量污染，折腾半天找不出原因。核心解决办法不外乎三种：用@run-at声明时机、调整启用顺序，或者干脆把脚本合并。其实关键原则很简单：让依赖其他脚本的那个后执行。

先给你一个结论：米侠浏览器里，多个油猴脚本在同一个页面同时触发时，执行顺序错乱是常见但可解的痛点。你必须通过手动干预，才能控制脚本的实际运行次序。

确认脚本是否真的存在执行顺序冲突

怎么确认？打开开发者工具（F12），切换到 Console 标签，刷新目标网页，看看报错信息里有没有 "ReferenceError: xxx is not defined" 或 "Cannot read property 'xxx' of undefined"。如果出现这类错误，而且那个缺失的变量恰恰是另一个脚本声明的，那几乎就是顺序冲突的铁证。

你也可以直接看 Network 面板，过滤出 JS 文件，检查各脚本的加载时间戳。不过要留个心眼：加载靠前不等于执行靠前。油猴类脚本通常等 DOM 构建完毕后才注入，真正决定执行顺序的是 @run-at 声明以及脚本管理器内部的调度逻辑。

方法一：用 @run-at 显式指定注入时机

进入脚本管理器，点击问题脚本右侧的“编辑”，在元数据区块（// ==UserScript== 与 // ==/UserScript== 之间）添加或修改 @run-at 这一行。常见的几个时机如下：

@run-at document-start：脚本在 HTML 解析开始前注入，适合重写原生 API（比如 fetch、XMLHttpRequest），但这时候还没任何 DOM 节点可操作。

@run-at document-idle：等 DOM 解析完成但还没触发 load 事件时执行，大多数 DOM 操作场景都够用了。

@run-at document-end：等 DOM 构建完毕、子资源（图片、CSS）还没加载完时运行，兼容性最广。

@run-at document-ready：相当于 jQuery 的 $(document).ready() 那个级别，前提是页面已经引入 jQuery 且脚本声明了 @require。

关键原则是：依赖其他脚本创建的全局变量或函数的脚本，必须把 @run-at 设得比被依赖脚本更晚。比如，A 脚本挂载了 window.myUtil，B 脚本要调用 myUtil.doWork()，那么 B 的 @run-at 就必须晚于 A（比如 A 用 document-idle，B 就用 document-end）。

方法二：调整脚本启用顺序并重启生效

这个方法不用改任何代码，直接影响到脚本管理器内部的执行队列排序。操作起来很简单：

第一步：在脚本管理器主界面，把待调整的脚本全部关闭（点击开关变成灰色）。

第二步：按你期望的执行先后顺序，依次点击脚本右侧的开关——谁先点的，谁就会排在执行队列前面。

第三步：全部开启后，注意，这一步最关键——必须完全退出米侠浏览器进程（Android 上清后台，Windows/macOS 上用任务管理器结束 mxx.exe），然后再重新启动。否则顺序缓存不会刷新。

第四步：刷新网页，在每段脚本里加上 console.log('A loaded') / console.log('B loaded')，验证输出顺序是否跟你预想的一致。

方法三：合并脚本或显式调用依赖项

当两个脚本存在强耦合的时候，硬拆成独立脚本反而增加顺序风险。比如一个提供工具函数，另一个负责业务逻辑，这种时候最稳妥的做法是主动收编：

方法一：直接把工具类脚本的内容复制到业务脚本的顶部，然后删掉原工具脚本，彻底消除顺序依赖。

方法二：在业务脚本开头插入同步等待逻辑（仅限于 document-end 及之后的时机）：while (typeof window.myUtil === 'undefined') { /* 空循环 */ }。不过不推荐这种写法，它很可能把页面卡死。

方法三（推荐）：改用 Promise + MutationObserver 来监听目标变量是否就绪：

const waitForUtil = () => new Promise(r => { 
  const check = () => { 
    if (typeof window.myUtil !== 'undefined') return r(); 
    requestIdleCallback(check); 
  }; 
  check(); 
});
waitForUtil().then(() => { /* 此处放你的主逻辑 */ });

注意，这个写法要求脚本的 @run-at 至少要设为 document-end，否则 window 对象可能还不能正常读写。