如何调整油猴脚本加载顺序，提升浏览器效率
目录导读
- 为什么脚本加载顺序如此重要？
- 油猴脚本加载顺序的默认机制
- 手动调整脚本顺序的三种核心方法
- 脚本依赖冲突的排查与解决技巧
- 进阶：利用脚本管理器自定义排序规则
- 常见问题QA：加载顺序故障自救指南
为什么脚本加载顺序如此重要？
油猴（Tampermonkey / Violentmonkey）脚本的加载顺序直接影响网页功能的稳定性，许多用户发现，当同时安装“去广告”“视频解析”“自动翻页”等脚本时，先加载的脚本会抢占DOM资源，而后加载的脚本可能因元素已被修改而失效。
- 脚本A先执行，隐藏了广告元素；
- 脚本B后执行，但依赖广告元素位置做样式调整，结果报错。
核心矛盾：脚本管理器默认按安装时间倒序加载（最新安装的优先），但这与脚本间的依赖关系常冲突。
油猴脚本加载顺序的默认机制
油猴的加载顺序并非随机，而是基于以下规则：
- 元数据优先级：脚本头部
@run-at指令决定执行时机（document-start、document-end、document-idle）。 - 安装时间：同优先级下，最新安装的脚本优先加载。
- 匹配域名：仅对当前域名生效的脚本才会加入排序队列。
关键限制：油猴不提供图形化拖拽排序界面，手动调整需依赖元数据修改或外部工具。
手动调整脚本顺序的三种核心方法
修改脚本元数据中的 @run-at 指令（最直接）
在油猴编辑器直接修改脚本头部：
// @run-at document-start // 页面加载前执行（优先级最高） // @run-at document-end // DOM加载完成后执行（默认） // @run-at document-idle // 页面完全渲染后执行（优先级最低）
适用场景：需要强制某个脚本在特定阶段执行，广告拦截脚本设为 document-start，样式补丁设为 document-end。
利用脚本依赖关系标识 @requires 和 @grant
在脚本中添加：
// @requires https://cdn.jsdelivr.net/npm/jquery@3.6.0
这会使油猴自动从CDN加载依赖库，但依赖脚本本身不会被强制排序，需配合 @run-at 实现伪排序。
通过脚本管理器重装或禁用/启用（间接排序）
- 重装旧脚本：让旧脚本的“安装时间”变新，提升加载优先级。
- 批量禁用-启用：先禁用所有脚本，按需要的顺序逐个启用（油猴会按启用顺序缓存排序）。
注意：此方法不够稳定，刷新页面后可能重置。
脚本依赖冲突的排查与解决技巧
当脚本顺序出错时，浏览器控制台（F12）会显示错误：
Uncaught TypeError: xxx is not a function→ 脚本顺序靠后，调用的函数尚未加载。Cannot read properties of null→ 依赖的元素被前序脚本删除或修改。
解决步骤：
- 打开油猴管理面板 → 检查所有脚本的
@run-at是否合理。 - 在冲突脚本的
@run-at后补加@noframes避免在iframe中重复执行。 - 使用
setTimeout或MutationObserver延迟执行特定功能：setTimeout(() => { /* 你的代码 */ }, 500); // 给其他脚本预留时间
进阶：利用脚本管理器自定义排序规则
部分高级脚本管理器（如Tampermonkey Beta版）支持 脚本组排序：
- 打开油猴设置 → “脚本组”标签页。
- 创建新组（如“广告屏蔽组”“功能增强组”）。
- 为组设置全局
@run-at优先级（组内脚本仍按默认规则排序）。 - 拖拽组次序即可实现批量调整加载顺序。
替代方案：若管理器不支持组功能，可安装 GM_config 扩展，通过可视化界面调整脚本顺序（部分用户脚本已集成此配置）。
常见问题QA：加载顺序故障自救指南
Q1：调整 @run-at 后脚本反而失效了？
A：document-start 阶段DOM未加载，需用 document-end 或 document-idle，例如DOM操作类脚本不可设为 start。
Q2：脚本A依赖脚本B，但B未执行A就报错？
A：在脚本A头部声明 // @require 引入脚本B的代码（但B需先挂载到 window 对象），更推荐将两者的依赖函数合并为一个脚本。
Q3：油猴无法加载外链CDN资源，导致排序失效？
A：检查 @grant 是否包含 GM.xmlhttpRequest 权限，CDN失败时，脚本会回退到本地版本，顺序不受影响。
Q4：如何查看当前网页脚本的实际加载顺序？
A：在油猴管理面板 → 编辑模式 → 脚本头部添加 console.log("当前脚本：", GM_info.script.name); 并在控制台查看输出顺序。
Q5：有没有一键重置排序的方法？
A：油猴无重置按钮，最彻底的方法是备份脚本 → 卸载油猴 → 重装 → 手动导入备份（会按导入时间重新排序）。
通过以上方法，你完全可以掌控自己浏览器中的油猴脚本加载优先级，无论是为了兼容多脚本协作，还是为了加速网页渲染，合理的排序能减少90%以上的冲突错误，建议每安装新脚本后，检查一次整体排序，逐步培养“脚本依赖审计”的习惯——这才是电脑工具脚本管理者的进阶之路。
标签： 脚本排序调整
