为何火狐浏览器中油猴脚本Tampermonkey不能正常注入DOM节点

火狐浏览器中Tampermonkey脚本无法注入DOM，主因是触发时机过早、权限不足或Firefox内容脚本隔离；需依次检查body存在性、调整@run-at值、用MutationObserver监听动态元素、启用扩展权限、关闭network_state分区，并针对性处理Shadow DOM。

火狐浏览器中油猴脚本Tampermonkey无法正常注入DOM节点，通常是因为脚本触发时机过早、权限限制未开启或Firefox特有的内容脚本隔离策略导致的——不是所有页面都能在DOMContentLoaded后立即操作元素，尤其遇到Shadow DOM、动态渲染框架（如React/Vue）或document.write重写页面的情况。

确认脚本运行时机是否匹配页面实际结构

第一步：打开开发者工具（Ctrl+Shift+I）→ 切换到“控制台” → 输入document.body，确认body是否存在；若返回null，说明脚本执行时HTML尚未解析完毕。

第二步：将脚本元信息中的@run-at从默认的document-idle改为document-end或document-start，并保存后刷新页面。注意：【@run-at document-start 会跳过DOMContentLoaded事件监听，仅适用于需劫持document.write或早期全局对象修改的场景】。

第三步：若目标元素由JavaScript异步加载（如分页列表、懒加载图片容器），必须配合MutationObserver或轮询检测，不能依赖单次DOM就绪事件。

检查Firefox扩展权限与站点隔离设置

点击地址栏左侧的扩展图标 → 点击Tampermonkey图标 → 选择“此网站的设置” → 确保“允许访问文件URL”和“允许在此网站上运行”均已启用。

进入about:config → 搜索privacy.partition.network_state → 若值为true，临时设为false（Firefox 108+默认启用网络状态分区，可能干扰脚本读取document.cookie或localStorage，间接影响DOM注入逻辑）。

绕过Shadow DOM或框架虚拟DOM的注入方法

方法一：使用document.querySelector配合shadowRoot递归查找

方法二：在脚本开头插入以下代码，强制等待Shadow Host渲染完成后再执行主逻辑：

const waitForShadow = (hostSelector, timeout = 5000) => new Promise(resolve => { const check = () => { const host = document.querySelector(hostSelector); if (host && host.shadowRoot) return resolve(host.shadowRoot); if (timeout

方法三：对Vue/React类SPA，监听history.pushState或hashchange事件，在路由变化后重新执行DOM查找——这一步操作起来很简单，直接把上述监听逻辑加进你的main()函数里就行。