若Tampermonkey脚本未生效，需依次检查：一、通过猴子图标进入管理面板启用脚本；二、在chrome://extensions/中确保插件本身已启用；三、核对@match规则是否匹配当前网址；四、手动点击“立即运行”验证；五、检查CSP限制及站点权限。
如果您已安装Tampermonkey插件但脚本未生效，则可能是由于脚本处于禁用状态、匹配规则不满足或管理器未正确加载。以下是启用脚本的具体操作路径：
一、通过Tampermonkey图标进入管理面板并启用脚本
点击浏览器右上角的猴子图标可快速访问脚本控制台，所有已安装脚本在此集中管理，启用状态需手动确认。
1、确保QQ浏览器已运行且Tampermonkey插件图标可见于工具栏右上角。
2、点击该灰色或橙色猴子图标，在弹出菜单中选择【管理面板】。
3、在打开的面板页面中，查看“已启用”列是否为勾选状态；若对应脚本显示为空白或叉号，则说明当前被禁用。
4、点击该脚本行最右侧的开关按钮，使其变为蓝色开启状态。
二、在扩展程序页面检查并启用Tampermonkey插件本身
Tampermonkey作为脚本运行的基础载体，若其自身被禁用，所有脚本均无法加载，必须优先确保其处于激活状态。
1、在QQ浏览器地址栏输入chrome://extensions/并回车，进入扩展程序管理页。
2、在列表中找到Tampermonkey条目，确认其右侧开关处于开启位置。
3、若开关为灰色且不可点，检查页面右上角【开发者模式】是否已开启；如未开启，请先开启后再尝试操作。
4、若插件显示“已禁用”，请手动点击开关将其切换为启用，并观察图标是否重新出现在工具栏。
三、检查脚本匹配网址规则是否覆盖当前页面
油猴脚本仅在@match或@include声明的URL范围内自动执行，若当前网页地址不匹配，脚本将保持静默，需核对并修正规则。
1、在Tampermonkey管理面板中，找到目标脚本，点击右侧的编辑按钮（铅笔图标）。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
2、在代码编辑区查找以@match开头的行，例如@match https://www.bilibili.com/*。
3、对比当前浏览网页的完整地址，确认是否符合通配规则；如访问的是https://www.bilibili.com/video/BV1xx411c7mD，则上述规则有效。
4、若不匹配，可在该行下方新增一行，填写当前网站域名格式，例如@match https://example.com/*，保存后刷新页面。
四、手动触发脚本运行以验证功能
部分脚本设置为延迟加载或依赖用户交互，可通过管理界面强制执行一次，用于快速判断脚本逻辑是否正常。
1、访问目标网页并等待页面完全加载完成。
2、点击工具栏猴子图标，在下拉菜单中展开已启用脚本列表。
3、找到对应脚本名称，若右侧显示“立即运行”按钮，则点击该按钮。
4、观察页面是否出现预期变化，例如广告区域消失、新增下载按钮或样式调整等视觉反馈。
五、检查浏览器内容安全策略与权限限制
某些安全策略会拦截外部脚本注入DOM节点，导致脚本虽启用却无实际效果，需临时放宽站点权限进行验证。
1、在当前目标网页右键空白处，选择【检查】或按F12打开开发者工具。
2、切换至Console（控制台）标签页，刷新页面，查看是否存在以"Refused to execute script"开头的报错信息。
3、若存在，点击地址栏左侧的锁形图标，选择【网站设置】→【JavaScript】→ 确认状态为“允许”。
4、返回扩展管理页chrome://extensions/，点击Tampermonkey右侧的【详细信息】，在“站点权限”中确认已授予“在所有网站上运行”权限。
