火狐油猴脚本失效通常因加载链路中断,需依次检查:脚本是否被加载(via about:debugging)、@match匹配精度、控制台报错(须开启“显示来自扩展的错误”)、最小环境验证、grant权限兼容性(禁用chrome.* API)、CSP拦截、隐身模式限制及系统时间偏差。

火狐浏览器中油猴脚本扩展无法正常生效,常见表现为页面无任何变化、功能按钮不出现、控制台静默无日志,甚至脚本图标右下角不显示数字提示——这通常不是单点故障,而是加载链路上某一个环节被切断所致。
确认脚本是否被火狐真正加载
打开火狐地址栏,输入 about:debugging#/runtime/this-firefox → 点击「检查」按钮 → 找到 Tampermonkey → 点击「调试」打开开发者工具 → 切换到「Console」标签页 → 刷新目标网页。
观察是否有类似 [Tampermonkey] Script 'XXX' loaded 的日志。没有该行,说明脚本压根没进加载队列。
【@match 必须精确匹配协议+域名+路径结构,例如 https://example.com/* 无法匹配 https://www.example.com/】。注意 www 是子域名,和根域名完全不等价;http 和 https 也互不兼容;末尾斜杠 / 有无都可能影响匹配结果。
查看浏览器控制台原始报错
方法一:按 Ctrl+Shift+K(Windows/Linux)或 Cmd+Option+K(macOS)直接打开 Web 控制台 → 切换到「错误」过滤项 → 刷新页面。
方法二:右键页面 → 「检查元素」→ 切换到「控制台」→ 必须勾选「显示来自扩展的错误」(Firefox 120+ 默认关闭此项,不勾选就等于关掉所有 Tampermonkey 错误可见性)。
若报错含 ReferenceError: $ is not defined,说明脚本依赖 jQuery 却没声明 @require;若出现 SyntaxError: illegal character,极大概率是复制时混入了零宽空格等不可见 Unicode 字符——全选脚本内容,粘贴到纯文本编辑器里再复制回来即可清除。
隔离验证最小执行环境
第一步:在 Tampermonkey 编辑器中,将整个脚本内容替换为以下最小验证代码:
// ==UserScript==<br>// @name Debug Test<br>// @namespace http://tampermonkey.net/<br>// @version 1.0<br>// @match *://*/*<br>// @grant none<br>// ==/UserScript==<br>alert("Loaded"); console.log("OK");
第二步:保存 → 刷新任意网页 → 若弹窗和日志均出现,说明 Tampermonkey 自身工作正常;若不触发,检查脚本是否被禁用(插件图标右键菜单里确认「启用此脚本」已勾选)。
第三步:逐步还原原脚本内容,每次添加 3~5 行后保存并刷新测试,直到报错复现——出问题的那几行就是根因所在。
检查 grant 权限与 Firefox API 兼容性
Firefox + Tampermonkey 组合下,Chrome 专用 API(如 chrome.storage.local)不可用,必须改用 GM_setValue / GM_getValue 等跨浏览器 API。
如果脚本头部写了 @grant chrome.storage 却没写对应 @grant GM_setValue,Firefox 会直接拒绝执行整段脚本,且控制台可能只报一行模糊的“未授权访问”,容易漏看。
部分银行或政务网站启用了 CSP 策略,禁止 eval 或内联脚本执行,此时脚本即使匹配成功也会被拦截——需联系作者获取免 eval 版本,普通用户无法自行绕过。
排查隐身模式与系统时间干扰
油猴默认不运行隐身窗口中的脚本。若你在隐私窗口测试,请点击油猴图标 → 右键 → 「设置」→ 勾选「允许在隐私窗口中运行用户脚本」。
系统时间不准也会导致失效:某些抢课、秒杀类脚本内置证书校验或时效性判断,若本地时间比实际快或慢超过 5 分钟,SSL 握手失败后脚本会静默退出,控制台不留痕迹。











