1. 那条黄色警告到底在说什么如果你最近打开浏览器发现右上角那个熟悉的黑色小猴子图标上多了一个红色的感叹号点开之后弹出一段话——“请启用开发者模式以允许用户脚本注入点击这里了解如何操作”——那你不是一个人。从 Chrome 120 版本前后开始大量用户陆续撞上了这个提示Tampermonkey 的脚本突然集体罢工网课助手不跑了页面净化脚本失效了连自己写的小工具都哑火了。这个提示的本质是浏览器厂商在扩展程序权限模型上做了一次收紧而 Tampermonkey 作为一个需要向任意网页注入代码的工具首当其冲被卡住了脖子。先把结论摆在前面这个提示不是 Tampermonkey 坏了也不是你的脚本写错了而是浏览器要求你手动确认“我信任这个扩展去修改网页”。在 Chrome 和 Edge 上对应的开关叫开发者模式在 Firefox 上机制略有不同但核心逻辑一致。你要做的就是把这个开关打开然后重新加载扩展。听起来简单但实际操作里有一堆细节会让新手卡住比如找不到开关、开了之后每次启动都提示、企业环境被策略锁死等等。这篇文章就把这些情况一次性讲透。这篇文章适合几类人看一是普通用户装了篡改猴但不懂技术只想让脚本赶紧恢复运行二是脚本作者需要理解权限模型的变化避免自己的脚本被误判三是运维或 IT 支持人员可能要批量处理一批机器的配置。不管你是哪一类我都会从原理讲到操作再讲到踩坑尽量让你看完就能动手解决。需要先说明一点本文讨论的所有操作都基于浏览器官方提供的扩展管理界面属于正常的软件配置行为。我不会涉及任何绕过安全机制的手段也不会推荐来路不明的第三方工具。我们做的只是把浏览器本来就提供的开关打开让合法的用户脚本能够正常运行。2. 浏览器为什么要逼你开这个开关2.1 用户脚本注入这件事天生就敏感要理解这个提示得先明白 Tampermonkey 到底在干什么。普通的浏览器扩展比如一个广告拦截器它主要通过浏览器提供的声明式接口去过滤请求权限边界相对清晰。但 Tampermonkey 不一样它的核心能力是在任意网页加载时把一段你自己写的 JavaScript 代码塞进页面里执行。这段代码能读取页面内容、修改 DOM、拦截网络请求、甚至读取你输入的表单数据。从浏览器安全模型的角度看这几乎等同于“让一个扩展拥有修改所有网站的能力”。这本身不是坏事——用户脚本生态里大量工具就是靠这个能力工作的比如给某个网站加上暗色模式、自动展开全文、批量下载图片。但问题在于这个能力如果被滥用风险也很直接恶意脚本可以偷偷把你的登录凭证发到别处可以在支付页面篡改金额可以伪装成银行页面骗你输入密码。所以浏览器厂商的态度一直是矛盾的既不想砍掉这个生态又想在权限上留一道闸门。早期的做法比较宽松扩展声明了权限就直接生效。后来逐步收紧要求用户在扩展管理页面手动开启某些高危权限。到了最近的版本Chrome 和 Edge 把“允许用户脚本”这个能力和开发者模式这个开关绑定在了一起。2.2 开发者模式被重新定义了很多人对“开发者模式”的印象还停留在“加载未打包扩展”那个用途上。以前你只有在开发自己的扩展、需要临时加载一个文件夹时才会去打开它。但现在浏览器把这个开关的语义扩展了它变成了一个“我确认我知道自己在做什么”的总开关。一旦打开浏览器就认为你是一个有判断力的用户愿意承担加载非商店扩展、允许脚本注入等行为的后果。这个设计逻辑其实不难理解。浏览器厂商的立场是普通用户不应该在不知情的情况下运行能修改任意网页的代码。如果你确实需要这个能力那你得主动跨过一道门槛这道门槛就是开发者模式。跨过之后责任转移到你身上。注意开发者模式打开后浏览器可能会在每次启动时显示一条“请停用以开发者模式运行的扩展程序”的提示条。这是正常现象不是报错关掉即可不影响功能。2.3 为什么偏偏是现在集中爆发你可能会问为什么以前没事现在突然就不行了。这背后是浏览器扩展平台的一次大版本迁移。Chrome 从 Manifest V2 向 Manifest V3 过渡的过程中对扩展的能力做了大量限制其中就包括对脚本注入方式的调整。Tampermonkey 为了适配新规范不得不改变自己的权限申请方式而新的方式恰好触发了开发者模式这个门槛。Edge 因为基于 Chromium所以行为基本一致。Firefox 的情况稍有不同它有自己的扩展权限体系Tampermonkey 在 Firefox 上通常不需要开发者模式但可能会要求你确认“访问所有网站数据”的权限。所以如果你在 Firefox 上看到类似提示处理方式是在扩展管理页面把权限改成“在所有网站上都允许”。3. Chrome 上的完整操作链路3.1 找到扩展管理页面的三种方式第一步永远是打开扩展管理页面。最直接的方式是在地址栏输入chrome://extensions/然后回车。这个地址是 Chrome 的内置页面不需要联网。如果你记不住也可以点右上角三个点找到“扩展程序”再点“管理扩展程序”。第三种方式是在地址栏右侧的拼图图标上右键选择“管理扩展程序”。打开之后你会看到已安装的扩展列表。Tampermonkey 通常显示为“篡改猴”图标是一只黑色小猴子。如果它上面有红色感叹号或者显示“已停用”说明它当前没有正常工作。3.2 打开开发者模式并重新加载在扩展管理页面的右上角有一个“开发者模式”的开关。把它拨到打开状态。打开之后页面顶部可能会出现一条提示告诉你“请停用以开发者模式运行的扩展程序”先不用管它。接下来找到 Tampermonkey 那一项点击它卡片上的“重新加载”按钮通常是一个圆形的刷新图标。重新加载之后Tampermonkey 会重新申请权限这时候浏览器可能会弹出一个确认框问你是否允许它访问所有网站。点“允许”或者“添加扩展程序”确认。完成之后Tampermonkey 的图标应该恢复正常不再有感叹号。你可以打开一个之前脚本失效的网站刷新页面看看脚本是否恢复运行。如果还是不行往下看第 5 节的排查部分。3.3 一个容易被忽略的细节扩展的“允许访问文件网址”有些脚本需要在本地 HTML 文件上运行比如你下载了一个网页保存到本地想用脚本处理它。这种情况下光开开发者模式还不够你还需要在 Tampermonkey 的详情页里把“允许访问文件网址”这个开关打开。这个开关默认是关闭的位置在扩展详情页往下拉找到“允许访问文件网址”那一项。打开之后本地文件的脚本才能生效。这个细节很多人不知道导致他们以为脚本坏了其实是权限没给全。4. Edge 上的差异与对应处理4.1 Edge 的扩展管理入口Edge 的操作和 Chrome 大同小异但入口位置略有不同。在地址栏输入edge://extensions/回车就能打开扩展管理页面。或者点右上角三个点找到“扩展”再点“管理扩展”。Edge 的开发者模式开关同样在页面左侧或者右上角不同版本位置有差异新版通常在左侧边栏底部。打开之后找到篡改猴点击“重新加载”。4.2 Edge 特有的“允许来自其他应用商店的扩展”Edge 有一个 Chrome 没有的选项叫“允许来自其他应用商店的扩展”。如果你是从 Chrome 商店安装的 Tampermonkey在 Edge 上可能需要打开这个开关才能正常更新和运行。位置在扩展管理页面的左侧边栏底部和开发者模式开关挨着。这个开关的作用是让 Edge 接受来自非 Edge 商店的扩展。打开它不会有什么副作用只是让 Edge 更宽容一些。如果你在 Edge 上遇到脚本不运行除了开发者模式也检查一下这个开关。4.3 Edge 的权限确认弹窗可能更频繁实测下来Edge 在权限确认上比 Chrome 更谨慎。有时候你重新加载了扩展它不会立刻弹窗而是默默把扩展停用等你下次打开浏览器时才提示。如果你发现 Edge 上篡改猴反复失效可以尝试在扩展详情页里把“站点访问权限”手动改成“在所有站点上”而不是依赖弹窗确认。5. 开了开发者模式还是不行怎么办5.1 先确认脚本本身有没有启用这是最常见的情况开发者模式开了扩展也重新加载了但脚本还是不跑。这时候先别怀疑浏览器去 Tampermonkey 的管理面板看看脚本是不是被禁用了。点浏览器右上角的 Tampermonkey 图标选择“管理面板”在脚本列表里看每个脚本前面的开关是不是绿色。有时候浏览器更新或者扩展重载会导致脚本被自动禁用手动打开即可。另外Tampermonkey 面板顶部有一个总开关如果它是灰色的说明所有脚本都被暂停了。点一下让它变成绿色。5.2 检查脚本的匹配规则如果脚本启用了还是不跑打开脚本编辑页面看头部的match或include规则。比如一个脚本写的是match https://example.com/*但你访问的是https://www.example.com那就匹配不上。这种情况需要修改规则或者用match *://*.example.com/*这种通配写法。还有一种情况是脚本用了run-at document-start但页面加载太快脚本还没来得及注入页面就加载完了。这种可以尝试改成run-at document-idle让脚本在页面空闲时再执行。5.3 浏览器缓存和 Service Worker 的干扰有时候脚本改了但没生效是因为浏览器缓存了旧版本的页面。可以按Ctrl Shift RMac 上是Cmd Shift R强制刷新。如果还不行打开开发者工具F12在 Network 面板勾选“Disable cache”然后刷新。另外某些网站注册了 Service Worker它会拦截请求并返回缓存内容导致脚本注入的时机错乱。可以在开发者工具的 Application 面板里找到 Service Workers勾选“Update on reload”或者直接 Unregister然后刷新页面。5.4 企业策略或安全软件锁死了开发者模式如果你在公司电脑上操作发现开发者模式开关是灰色的点不动那大概率是被组策略锁定了。Chrome 和 Edge 都支持通过策略强制禁用开发者模式这是 IT 部门为了防止员工安装未授权扩展而做的限制。这种情况下你个人无法绕过需要联系 IT 部门申请。同样某些安全软件会监控浏览器扩展的加载行为把 Tampermonkey 的脚本注入当成可疑行为拦截。如果你装了这类软件可以看看它的拦截日志把 Tampermonkey 加入白名单。6. 脚本作者的应对怎么让自己的脚本更稳6.1 在脚本头部声明必要的权限如果你是自己写脚本的人可以在脚本头部用grant声明需要的权限。比如grant GM_setValue表示需要存储权限grant GM_xmlhttpRequest表示需要跨域请求权限。声明得越明确Tampermonkey 在申请权限时越顺畅也越不容易被浏览器误判。另外connect用来声明允许跨域请求的域名写清楚能减少运行时的拦截。比如connect api.example.com。6.2 避免使用被新规范限制的 APIManifest V3 之后一些旧的 API 被限制了比如GM_xmlhttpRequest的某些用法、unsafeWindow的直接访问等。如果你的脚本大量依赖这些可能会在新版浏览器上表现不稳定。建议逐步迁移到官方推荐的写法比如用GM.xmlHttpRequest替代旧版用window的代理访问替代直接操作unsafeWindow。6.3 给用户写清楚安装说明很多用户卡住不是因为技术问题而是因为不知道要开开发者模式。作为脚本作者可以在脚本发布页面的说明里加一段“安装后请确保浏览器开发者模式已开启”的提示附上简单的操作步骤。这样能减少大量重复的求助。7. 几个高频疑问的集中解答7.1 开发者模式一直开着安全吗从功能角度说一直开着没有额外风险它只是让浏览器允许加载未打包扩展和用户脚本。真正的风险来自你安装了什么东西而不是这个开关本身。只要你只从可信来源安装脚本保持开启是没问题的。如果你实在介意可以在不用的时候关掉但每次重启浏览器后 Tampermonkey 可能会再次失效需要重新打开。7.2 为什么每次启动浏览器都提示“请停用开发者模式”这是浏览器的固定行为只要开发者模式开着它就会在启动时显示这条提示条。它不会自动关闭你的扩展只是提醒你注意。你可以点提示条右侧的关闭按钮把它关掉下次启动还会出现。目前没有官方提供的永久关闭这个提示的方法只能习惯它。7.3 手机浏览器上有没有这个问题手机端的 Chrome 和 Edge 对扩展的支持一直很有限Tampermonkey 在移动端主要通过 Kiwi Browser、Yandex Browser 等支持扩展的浏览器运行。这些浏览器的权限模型和桌面端不同通常不需要开发者模式但可能需要手动开启“允许安装未知来源扩展”之类的选项。如果你在移动端遇到问题建议先确认你用的浏览器是否支持扩展。7.4 旧版本浏览器会不会没这个问题确实Chrome 109 及更早的版本以及一些基于旧版 Chromium 的浏览器可能不会弹出这个提示因为它们的权限模型还没更新。但旧版本浏览器有安全风险不建议为了省事而停留在旧版本。正确的做法是升级到新版然后按本文的方法配置。8. 我自己的使用习惯和几点建议用了这么多年篡改猴我现在的习惯是开发者模式常年开着不去折腾它。每次浏览器大版本更新后如果发现脚本失效第一件事就是去扩展管理页面点一下重新加载九成问题都能解决。剩下的一成要么是脚本本身需要更新要么是网站改版导致匹配规则失效。另外一个小技巧如果你同时用 Chrome 和 Edge可以把 Tampermonkey 的脚本通过云同步功能同步过去这样换浏览器不用重新配置。Tampermonkey 自带同步功能在设置里开启即可支持多种同步方式。最后提醒一句安装脚本时尽量看清楚脚本的权限声明和来源。一个正常的脚本不会要求读取你的密码或者发送数据到陌生服务器。如果某个脚本的代码里出现了可疑的网络请求果断删掉。工具本身是中性的关键在于你怎么用。
