手动触发 Tampermonkey 脚本更新检查的几种方式
自动更新按周期跑,但「作者刚发了修复版,我现在就想更上」的场景需要手动触发。官方把「发起更新检查」列为弹出菜单的核心能力之一。
从弹出菜单触发
- 点地址栏旁的 Tampermonkey 图标;
- 弹出菜单里找到检查更新入口(部分版本在菜单底部);
- Tampermonkey 立刻遍历脚本逐一询问更新源,结果以通知或列表变化呈现。
从管理面板触发
- 管理面板工具栏有更新检查按钮,作用范围是全部脚本;
- 部分版本支持对单个脚本右键/操作菜单单独检查更新。
更新检查的前提
脚本能不能被更新,取决于脚本头部的声明:
- 头部有
@version字段才有更新检查的意义(官方文档注明:没有版本号,更新检查不工作); - 有
@updateURL用声明地址询问,没有则按安装来源推断; @downloadURL none是作者主动声明「此脚本不更新」;- 这组字段的细节见元数据头总览。
自动更新的周期在哪调
手动更新是应急,日常节奏由自动检查频率决定:设置页的更新区可以设置检查间隔,见自动更新设置。
更新失败的常见原因
| 现象 | 可能原因 | 出口 |
|---|---|---|
| 提示主机权限受限 | Site Access 被设为特定站点 | Site Access 限制 |
| 一直停在检查中 | 更新源地址不可达或被墙 | 换网络环境验证 |
| 更新后脚本坏了 | 新版本与浏览器/其他脚本不兼容 | 管理面板里恢复或回退版本 |
| 批量更新全失败 | MV3 权限开关问题 | 允许用户脚本开关 |