首先确认油猴扩展已启用，检查脚本启用状态、匹配规则是否包含当前网址，调整@run-at执行时机，查看控制台错误信息定位问题，排除其他扩展冲突，必要时重新安装最新版本脚本。
如果您安装了油猴脚本但发现其未按预期运行，可能是由于脚本未正确加载、权限设置问题或页面匹配规则不生效。以下是排查和解决此类问题的具体步骤。
本文运行环境：MacBook Pro，macOS Sonoma
一、确认油猴扩展已启用
确保浏览器中的油猴扩展本身处于激活状态，否则所有脚本都无法执行。可通过浏览器扩展管理页面检查其运行情况。
1、打开浏览器右上角的扩展程序菜单，点击“管理扩展”。
2、找到 Tampermonkey 或 Greasemonkey 扩展，确认开关为开启状态。
3、确保扩展图标显示为完整的眼睛或绿色状态，表示已启用。
二、检查脚本是否启用
即使扩展已开启，单个脚本也可能被手动关闭，需确认目标脚本在油猴面板中处于启用模式。
1、点击浏览器工具栏中的油猴图标，进入脚本管理界面。
2、查找当前需要运行的脚本，确认其左侧的启用按钮为高亮或开启状态。
3、若已禁用，点击切换为启用，并刷新目标网页进行测试。
三、验证脚本的匹配规则（@match / @include）
脚本依赖元数据块中的 @match 和 @include 规则判断是否在当前页面运行。若规则不包含当前网址，则脚本不会执行。
1、在油猴管理界面点击脚本名称进入编辑模式。
2、查看代码顶部的 // @match 或 // @include 行，确认当前访问的 URL 是否符合其中任意一条规则。
3、可临时添加一行 // @match *://*/* 以测试是否为匹配问题，测试后请恢复原规则。
四、检查页面加载时机与执行模式
某些脚本因执行时机不当（如页面元素尚未加载）而失败，可通过调整注入方式解决。
1、编辑脚本，在元数据块中找到 // @run-at 字段。
2、将其设置为 // @run-at document-start 或 // @run-at document-idle，视需求调整。
3、例如，若脚本操作 DOM 元素，应确保页面已基本加载完成，推荐使用 document-idle。
五、查看浏览器控制台错误信息
控制台会记录脚本执行过程中的语法错误、跨域请求拒绝等异常，是调试的核心工具。
1、在目标网页按下 F12 打开开发者工具，切换到“Console”标签页。
2、刷新页面，观察是否有红色错误提示，特别是来自用户脚本（userscript）的内容。
3、重点关注报错行号及错误类型，如 ReferenceError 或 TypeError，据此修改脚本代码。
六、禁用其他冲突扩展
广告拦截器或其他内容修改类扩展可能干扰油猴脚本的正常执行。
1、进入浏览器扩展管理页面，逐个禁用 AdBlock、uBlock Origin 等常见扩展。
2、每禁用一个，刷新目标网页观察脚本是否恢复正常。
3、若发现问题扩展，可将其从特定站点屏蔽或调整油猴脚本的执行优先级。
七、重新安装或更新脚本
脚本文件可能因下载不完整或版本过旧导致执行失败，重新获取最新版本常能解决问题。
1、在油猴管理界面删除当前脚本。
2、前往原始发布页面（如 Greasy Fork）复制最新代码。
3、点击油猴图标选择“添加新脚本”，粘贴代码并保存。
