先说一个我自己的经历:几年前我第一次接触 Tampermonkey(油猴),是因为一个特别无聊的需求——把某个论坛帖子里的“只看楼主”按钮挪到页面顶部。当时我不懂前端,也不会写代码,纯粹是照着网上教程装了个插件,复制了一段脚本,没想到还真成了。从那以后,清理网页广告、自动展开全文、跳过视频片头、批量下载图片,凡是浏览器里让人手痒的重复操作,我几乎都习惯先搜一搜有没有现成的油猴脚本。
这一写,就用到了现在。
这篇文章我打算把整套流程从头到尾捋一遍,包括 Tampermonkey 是什么、它和普通浏览器扩展有什么本质区别、Chrome / Firefox / Edge 三个浏览器分别怎么装、装完之后仪表盘里那些选项到底是什么意思、脚本去哪里找、怎么安装、出问题了怎么排查。文中所有操作步骤都是我在真实环境里跑过的,平台版本也尽量标清楚,方便你对照自己的环境复现。
如果你是第一次听说油猴,看完应该能独立完成从装插件到跑起第一个脚本的全部流程;如果你装了但一直没用明白,后半部分的排查思路和脚本管理技巧,应该能帮你省不少事。
1. 为什么要装油猴:它本质上是一套“网页运行环境”
先花点时间把概念理清楚,后面操作才不会懵。
Tampermonkey 是一个浏览器扩展,但它的定位很特殊:它不是直接给你提供某一种功能,而是给一类叫“用户脚本”的文件提供运行环境。用户脚本本质上是一段 JavaScript 代码,写的是“当我在某个网站上时,帮我自动做某些事情”。比如自动填表单、去广告、破解网页右键限制、把网页里的图片列表转成预览图,全是这类脚本的典型用途。
打个比方:浏览器扩展商店里的普通扩展,相当于你买了个现成的家电,接通电源就能用;而油猴更像是一个万能插座,你只需要把不同的“插头”(用户脚本)插上去,它就能驱动不同的设备。你装的不是某个具体功能,而是一套能加载、管理、运行无数个小程序的基础设施。
这也是为什么油猴在技术圈里口碑两极分化——有人觉得它神,有人觉得它危险。神的地方在于,它让一些很小的功能需求不必做成完整的浏览器扩展,写十几行代码就能解决;危险的地方在于,用户脚本拥有很高的权限,能读取你在网页上的操作,如果你装了一个来路不明的脚本,它完全可以把你填的表单数据悄悄上传走。
所以我一直强调一个原则:装扩展只解决“能不能跑”的问题,脚本来源才决定“安不安全”。油猴官方平台(Tampermonkey 官网)本身是干净可靠的,但真正的风险在于你后面从第三方网站下载脚本的时候,一定要看清楚脚本内容大概在做什么,至少扫一眼 @match 字段,确认它只在你需要的网站上运行。
2. 下载安装前的准备:三个浏览器的差异必须先知道
很多人直接在浏览器应用商店搜索“油猴”,结果装上后发现界面是英文的,或者根本搜不到,就开始怀疑自己装了个假的。其实 Tampermonkey 在不同浏览器的分发渠道和安装体验差别挺大,我分别说一下。
2.1 Chrome:最好的安装途径其实是官方应用商店
Chrome 的扩展应用商店里是有 Tampermonkey 的官方版本的,直接访问 Chrome 应用商店,搜索 Tampermonkey,认准开发者“Tampermonkey”,点安装就可以。
这是整个流程里最顺畅的一条路,因为 Chrome 对商店内扩展的信任度最高,安装后不会出现“开发者模式”提示,也不会隔几天就弹窗说扩展程序被停用。
但这里有个很现实的问题:Chrome 应用商店在国内网络环境下访问经常不稳定,很多时候你打开了页面,扩展列表却一直加载不出来。这个问题的本质是网络连通性问题,不是 Tampermonkey 本身的问题。如果你遇到这种情况,可以试试刷新几次,换个网络环境,或者直接用 Firefox / Edge 的应用商店装,后面我也会讲这两个浏览器的具体方式。
2.2 Edge:装它要走“允许其他来源”这条路
Edge 从 2020 年转向 Chromium 内核之后,Chrome 的扩展绝大多数都能直接装进去。但 Edge 的应用商店里上架的 Tampermonkey 版本更新比较滞后,经常比 Chrome 上的落后几个版本,而且搜索出来的一堆扩展里,鱼龙混杂,认不准容易装错。
我的建议是:如果 Edge 是你长期使用的浏览器,第一次安装还是走一次 Chrome 应用商店的安装流程,把 Tampermonkey 这个扩展装进去,后续更新就交给 Edge 自己去同步了。装的时候 Edge 会自动检测到这是一个来自其他商店的扩展,并在安装按钮旁边多点一个确认。如果它不给你装,你就需要先在扩展管理页面打开“允许来自其他应用商店的扩展”这个开关。
这个开关默认是关的,原因是微软想尽量保证用户只从自家商店装应用,降低安全风险。但用油猴本来就要自己承担脚本风险,打开这个开关之后你才有资格说“我对自己装的东西负责”。
2.3 Firefox:官方商店上架,但插件审核更严格
Firefox 的 AMO(Add-ons for Firefox,官方插件商店)里就能直接搜到 Tampermonkey,安装流程最简单,基本就是一键完成,后续更新也是全自动的。
Firefox 有个特点:它对插件内容的审核比 Chrome / Edge 严格得多,这也意味着商店里的油猴版本通常不是最新的。如果你是那种“必须马上用上最新功能”的人,可能需要考虑用 Firefox 的“从文件安装附加组件”功能,手动下载 xpi 文件安装,但这会麻烦一些,而且每次升级也要手动操作。
对于绝大多数人,我建议跟着官方商店走,版本滞后几周完全不影响日常使用。
2.4 避坑:仿冒软件和第三方安装包的坑
这里必须提一下“Tempermonkey”,这个拼写和我上面一直写的“Tampermonkey”只差一个字母,但它是仿冒品,不是一个东西。第三方下载站上经常把这种假货和真货混在一起,如果你从非官方渠道下载安装,装的可能是带广告甚至带追踪功能的改版。
所以安装时认准两个硬指标:
- 网址是 tampermonkey.net 的来源
- 扩展详情里开发者名称为“Tampermonkey”
如果不是,删了重装。
3. 安装实操:Chrome / Firefox / Edge 的分步安装与权限确认
现在正式进入安装环节。别觉得简单,我见过不少人在“安装扩展”这一步卡住,原因五花八门——不是按钮点了没反应,就是提示扩展损坏。我把三个浏览器各自的安装要点拆开讲。
3.1 Chrome 安装全流程
打开 Chrome,进应用商店搜 Tampermonkey,点“添加至 Chrome”,浏览器会弹出一个权限说明,说明这个扩展可以读取和更改你访问网站上的所有数据——看到这个别慌,这是油猴运行的基本权限,因为脚本就是在你访问的网页里执行的。
点“添加扩展程序”,装好后右上角会出现一个黑色的 Tampermonkey 图标(默认是黑底白色拼图块)。如果没看到,就点浏览器右上角的拼图图标,进入扩展列表,找到 Tampermonkey,把图标固定到工具栏就行。
装完建议先打开扩展详情,手动确认一下“允许访问文件 URL”这个权限。如果不打开,某些在本地文件(比如通过 file:// 打开的 HTML 文件)上运行的脚本是无法生效的。这个选项在扩展详情页的“网站访问权限”区域。
3.2 Chrome 扩展安装失败了的排查思路
如果你的 Chrome 提示“无法安装扩展程序”或“扩展程序包无效”,大多数情况是你不是从商店安装的,而是拖了一个 crx 文件进浏览器,或者用了“开发者模式”加载解压的扩展。
Chrome 很早就禁用了传统的拖拽安装 crx 的方式,这是很正常的平台限制,不是你的操作问题。如果你必须走离线方式安装,比较稳妥的路径是:
- 先把 crx 文件下载到本地
- 在扩展管理页(chrome://extensions/)里打开“开发者模式”
- 把 crx 文件拖到这个页面里,会弹出一个确认框,点“添加扩展程序”
这个方式我只能说“多数时候能用”,但新版 Chrome 对这个方式也加了越来越多的限制。如果你试了两次还是失败,我建议别在一个方案上死磕,直接换个浏览器,或者用虚拟机单独装一个浏览器来跑离线扩展。
3.3 Edge 安装里的两步关键确认
Edge 安装 Tampermonkey 有两种情况:
第一种,直接从 Edge 应用商店装。搜索 Tampermonkey,认准名称和作者,点获取,一路确认即可。这种情况不需要额外设置,和普通扩展一样。
第二种,你想装 Chrome 应用商店里最新的 Tampermonkey 版本,那就要先进 Edge 扩展管理页面(edge://extensions/),在左侧找到“允许来自其他应用商店的扩展”,打开它。然后去 Chrome 应用商店搜索安装。
第二种方式最容易被忽略的是:安装完这个开关保持打开状态也没关系,不用关。真正需要留意的反而是“提示扩展来自其他商店且未经微软验证”的确认框,一定要点“仍然安装”,否则装到一半会停下来。
3.4 Firefox 安装:量大管饱但审核慢
Firefox 里直接搜 Tampermonkey,进入详情页,点添加,会再出现一个“由 Mozilla 验证”的提示,确认添加。装完后图标出现在工具栏,整个流程确实简洁。
不过 Firefox 的 AMO 对扩展版本审核有时候会卡很久,出现过我在 Chrome 上已经用上新版油猴,Firefox 上却还停在旧版本的情况。这种延迟不影响正常使用,但如果你发现 Firefox 的油猴在一些网页上行为不正常,先确认一下版本是不是太旧了,再去考虑换新版脚本的事。
3.5 装了之后先确认图标可点击
三个浏览器装完之后的共同动作:点一下工具栏里的 Tampermonkey 图标,确认能弹出一个下拉菜单。这个菜单里能看到“添加新脚本”“已安装脚本”“功能开关”等选项。如果点图标没反应,或者图标是灰色的,说明扩展初始化失败了。
这时候先去扩展管理页手动停用再启用一次,还不行就卸载重装。九成的“图标没反应”问题都能通过重启浏览器解决,我建议不要一上来就卸载,先把浏览器完全退出再重新打开,这个简单的动作解决过很多次莫名其妙的问题。
4. 第一次打开油猴:仪表盘里的设置项到底该改哪些
安装完成后,点油猴图标,选“控制面板”或“已安装脚本”,会进入一个管理界面。很多人一进来就被各种英文选项吓到,其实核心要弄明白的没几项。
4.1 已安装脚本列表:开关是灵魂
仪表盘的主界面是一个表格,列出你安装过的所有脚本。表头通常包括状态、名称、版本、适用网站、上次更新等。每个脚本前面有一个开关按钮,绿色/蓝色表示启用,白色/灰色表示停用。
这个开关是调试脚本的第一入口。遇到某个网页行为异常时,我建议你第一时间先用这个开关关掉对应脚本,刷新页面测试,而不是直接删脚本。通过“关灯对照”的方式验证是不是脚本导致的,这个习惯能省掉大量无效排查。
4.2 设置面板里的三个必调项
点仪表盘顶部的“设置”,会进入详细设置页面。新装之后我通常建议改三项。
第一项,把“配置模式”改为“专家”。这个选项在设置页右上角,默认是“初学者”,很多高级选项会在普通模式下隐藏。改成专家之后,高级页签里会出现很多可调参数,即使暂时用不上,至少能看到有哪些功能,排查问题的时候多了思路。
第二项,在“通用”页签里找“启用 Tampermonkey”。这个东西如果关了,油猴整体停用,所有脚本都不运行。排查脚本失效时可以试一下;平时保持开启就行。
第三项,“高级”页签里有一个“移除确认弹窗”,建议在你自己处理了大量脚本之后打开,因为每次安装脚本都弹一次确认窗口确实烦,但如果你还分不清脚本好坏,建议先别关。
4.3 而不是急着改的一些选项
设置面板里还有很多其他选项,比如通知、徽标、快捷键、网络请求模式等等,这些我建议新手暂时都不要动。原因很简单:油猴的默认配置是经过全局优化的,在理解每一项的含义之前乱改,很容易造成“原来能跑的脚本现在不跑了”这种莫名其妙的问题。
等你在某些特定场景下遇到了明确痛点,比如“脚本里的 GM_xmlhttpRequest 总是失败”或“徽标数量遮挡了网页内容”,再来对症下药改设置,那时候你已经知道改哪个选项会有什么效果了。
5. 获取和安装用户脚本:GreasyFork 的用法与安装注意事项
油猴装好了,但里面空空如也,还差最后一步——装用户脚本。这里最重要的平台是 GreasyFork,全球最大的用户脚本分享社区,没有之一。
5.1 在 GreasyFork 上找到靠谱的脚本
打开 greasyfork.org 之后,你会看到顶部有搜索框,还有脚本列表的排序选项,最常用的排序是“安装量”和“按投票排序”。
搜索的时候有个小技巧:大多数脚本的名称和介绍都是英文,你用英文关键词搜索命中率远高于中文。比如你想找一个下载视频的脚本,搜 video download 比搜“视频下载”找到的选项多得多。遇不到中文脚本也不用担心,GreasyFork 上英文脚本同样可以在中文网站运行,脚本的行为和网站语言无关。
点进一个脚本详情页后,重点看三个指标:
- 使用次数:次数越高通常代表脚本越成熟
- 反馈区:看最近有没有人报错,以及作者是否还在维护
- 最后更新日期:超过一年没更新的脚本,在如今网站频繁改版的环境下大概率失效
5.2 安装脚本的操作过程
在脚本详情页,点绿色的“安装此脚本”按钮,GreasyFork 会生成一个 .user.js 后缀的文件,这就是用户脚本的标准打包格式。点击安装按钮后,油猴会自动接管,弹出一个安装确认页面,页面里能看到脚本的作者、名称、版本,以及最关键的“正在运行于”或 @match 信息——这个字段告诉你脚本运行在哪些域名下。
确认运行范围符合你的预期后,点右上角的“安装”按钮,脚本就进入你的油猴列表了。此时回到任意一个脚本匹配的网站页面,刷新一下,油猴图标上会显示一个红色的数字角标,代表当前页面上运行了几个脚本。
5.3 安装多个脚本时怎么避免冲突
有些人一口气装了几十个脚本,结果发现网页乱了套。问题通常不是某个脚本坏了,而是两个脚本在同时操作同一个页面元素,互相打架。
排查思路是:在油猴仪表盘的设置里,打开“已安装脚本”列表,逐个停用,每停用一个就刷新一次页面看症状是否消失。这种二分法排查比一次性全关了再挨个开启效率高得多。
还有一个预防冲突的小技巧:同一个页面尽量只保留一个功能相似的脚本。比如你不需要同时装两个去广告脚本,功能重叠越多,冲突概率越高。
6. 油猴使用中的常见故障排查:从图标消失到脚本失灵
工具用久了总会出幺蛾子。这一部分我整理了我这几年遇到最多的几类问题和对应的排查链路,基本都是可以直接复现步骤的。
6.1 油猴图标不见了或变灰了
图标不见分两种情况。
一种是图标从工具栏消失,但扩展还装着的。去扩展管理页,找到 Tampermonkey,点击“固定”按钮,让它在工具栏显示出来。这是最常见也最好解决的问题。
另一种是图标呈灰色,点击之后菜单显示“已禁用”之类的提示。这种情况有两种可能:一是浏览器扩展的总开关没打开,去扩展管理页确认是“启用”状态;二是油猴自己的“启用 Tampermonkey”被关了,去油猴设置里的通用页签打开。
6.2 脚本装了但就是不生效
这大概是最让人郁闷的场景:脚本明明在列表里,网站也匹配,就是不干活。我的排查链路通常是:
先把浏览器完全退出再重进,刷新页面。油猴的脚本是在页面加载时就注入执行的,很多页面在打开之后才改结构,所以脚本不生效时第一件事永远是刷新。
刷新没用的话,打开浏览器的开发者工具,切到 Console(控制台)面板,看有没有报错。如果看到红色报错信息,多半是脚本本身的问题:要么是脚本版本太旧,匹配不了网站当前的结构;要么是脚本用到了一些你没开的 API,比如 GM_setValue 存储相关的东西。
还有一种隐藏情况:网站本身屏蔽了脚本注入。部分网站会通过内容安全策略(CSP)限制外部脚本运行,油猴在这种情况下确实很难正常注入脚本,这不是你操作有误,是网站的技术保护措施。
6.3 某个脚本突然失效,怎么判断是网站改版还是脚本问题
网站的页面结构是天天变的,脚本的嗅探逻辑往往会失效。判断方法是打开 GreasyFork 的脚本详情页,看反馈区有没有人跟你有同样的问题。如果有,说明脚本已经过期,等作者更新或者换个代替品即可;如果只有你一个人报错,那另说。
另有一种容易误判的情况:脚本更新了,但你的浏览器还缓存着旧版本。油猴默认每 24 小时检查一次脚本更新,点油猴图标选“检查脚本更新”可以手动触发。更新完脚本后,一定要刷新一下正在运行的网站页面,让新代码重新注入页面。
6.4 修改脚本后不生效:大概率是没保存
最后一个很低级、但特别容易被新手忽略的坑:在油猴内置的脚本编辑器里改完代码,直接关了窗口,以为自动保存了。其实编辑器不认识 Ctrl+S 的话,你的改动就丢了。
正确姿势是:编辑器里改完,按 Ctrl+S 保存,再关闭编辑器窗口。如果关了编辑窗口再重开,看到自己的改动还在,那才算真正保存成功。
还有,改完脚本后,你当前已经打开的网站页面不会自动重新加载新代码,必须手动刷新页面,修改才能生效。这个点我每次遇到都会提醒一遍,因为我自己也栽过好几次。
说到底,油猴的价值不在于它是一个多高深的工具,而在于它让浏览器变成了一套可以随意定制行为的工作台。你不需要懂太多代码,只要会装、会找、会分辨脚本好坏,就已经能享受它带来的效率提升。脚本社区最大的魅力是创造和分享,你在使用过程中如果有点子,也可以试着改一改别人的脚本,满足自己的需求——这个从“用”到“改”的过程,才是真正打开油猴正确玩法的开始。