打开 Tampermonkey 的调试日志看扩展后台输出
脚本「好像没跑」「跑得不对」,页面上又看不出所以然时,需要看 Tampermonkey 自己的日志输出。官方 FAQ Q600 给出了完整路径。
第一步:把日志级别调到 Debug
默认日志级别下,后台几乎不输出。开启方法:
- 点 Tampermonkey 图标 → 管理面板;
- 切到设置标签;
- 把 Logging Level(日志级别)设为 Debug。
第二步:打开对应的控制台
官方说明日志可能写到三个不同的控制台,按要查的内容选:
1. 后台上下文控制台(查扩展自身行为)
- 新标签打开扩展管理页(
chrome://extensions); - 找到 Tampermonkey,点详情;
- 在「检查视图 / Inspect views」区点 service worker 链接,DevTools 在新窗口打开;
- 这里输出扩展后台的运行日志——脚本匹配、更新检查、GM 请求的底层记录都在这。
官方注明:打开 service worker 检查会让它保持活跃,反而改变了「后台休眠」的默认行为——调试完记得关。
2. 页面控制台(查脚本输出)
目标页面按 F12 → Console 标签。脚本里 console.log 的输出、页面侧的报错在这里。
3. 浏览器警告/错误页
个别扩展级错误会呈现在扩展管理页的错误入口。
各控制台查什么
| 要查的问题 | 去哪个控制台 |
|---|---|
| 脚本有没有被注入、被什么规则拒绝 | 后台控制台 |
| 脚本自身逻辑输出与报错 | 页面控制台 |
| 更新检查失败原因 | 后台控制台 |
| 语法错误 | 编辑器 ESLint(见ESLint 检查) |
调完记得收尾
Debug 级别日志量可观,排查完把日志级别调回默认,避免无谓的输出开销。