提到 Tampermonkey技术圈里可能有人一时反应不过来但说“油猴”几乎每个折腾过浏览器的朋友都会心一笑。这个自带小猴子图标、又常被网友打成“油泼猴”的浏览器插件已经成了 Chrome 用户玩转网页的招牌工具。它到底是什么简单说Tampermonkey 是一个用户脚本管理器负责把一段段 JavaScript 代码按规则注入到指定网页里然后网页就能按你想要的方式运行。视频下载、去广告、自动翻页、一键复制、页面改版甚至给 B 站加上你想要的播放倍率都属于它的工作范围。如果你刚接触油猴肯定会有这些疑问在哪里下载才靠谱三个主流浏览器安装方式有没有区别脚本去哪儿找装上之后怎么管理和排查问题这篇教程我就从最基础的下载安装讲起一直聊到脚本管理、安全判断和常见故障处理带你完整体验一遍油猴的下载-安装-使用全流程。1. 油猴到底是什么写在动手之前很多新手以为油猴本身是个“万能工具箱”装完就能自动干活。这个理解有偏差。油猴的中文名源自 Tampermonkey 的直译本质是一个“用户脚本管理器”。用户脚本Userscript是用 JavaScript 写的、专门针对某一个或某一类网站做二次开发的代码片段。油猴负责的是把这些脚本在适合的时机、适合的页面上注入并运行再提供一套跨浏览器统一使用的各类接口。你可以把它想象成一个“应用商店加运行环境”的合体脚本是商店里的一个个小应用油猴则负责下载、安装、更新、启停和安全隔离。1.1 用户脚本和脚本管理器是什么关系没有用户脚本油猴就是个空壳没有油猴普通人拿到一段用户脚本也不知道怎么让它跑起来。举个例子你希望打开某个新闻网站时自动把正文里的广告节点删掉这段“扫描页面、找到广告、执行删除”的代码就是用户脚本。但浏览器出于安全考虑不会让陌生脚本直接操作页面。油猴做的就是这件事它给脚本提供了一块受控的运行空间根据脚本头部声明的匹配规则比如match https://example.com/*只在符合规则的网页上运行对应的代码。这带来两个实实在在的好处。第一安全隔离。脚本里的功能只在声明过的域名下生效不能跑到银行、邮箱页面乱改内容。第二跨浏览器统一。同一个脚本在 Chrome、Firefox、Edge 里写法和接口几乎一致油猴把浏览器之间的差异都抹平了。1.2 为什么选 Tampermonkey 而不是其他管理器用户脚本管理器不止油猴一个。资历最老的 Greasemonkey 是 Firefox 上的老祖宗但这些年更新节奏明显放缓对 Chromium 系浏览器支持也不如从前。暴力猴Violentmonkey主打开源轻量代码简洁用它的人也很多。那为什么市面上最出名的还是 Tampermonkey我个人体会最深的还是三点一是兼容性。Tampermonkey 对各大浏览器的适配做得最全面Chrome、Edge、Firefox、Opera甚至部分国产 Chromium 浏览器都能装上。二是 API 完整度。脚本开发中常用的GM_setValue、GM_getValue、GM_xmlhttpRequest、GM_addStyle等接口在 Tampermonkey 里覆盖得最齐全很多 Greasy Fork 上的知名脚本都会优先按它的接口标准来写。三是更新频率。它一直保持活跃更新浏览器内核一变它很快就能跟上不易失效。提示如果你只在 Firefox 上用Greasemonkey 也够用如果你追求开源极简Violentmonkey 是不错的选择。但作为一篇入门教程我建议新手优先选 Tampermonkey原因就一条遇到问题能搜到的解决方案最多坑最少。2. 下载安装全流程Chrome/Firefox/Edge 三端详解油猴的安装并不复杂但不同浏览器之间确实存在一些细节差异。下面我按照最推荐的官方商店路径再到官方备选渠道把三个浏览器的情况分开讲清楚。2.1 商店安装最省事的官方入口先给个总览表方便你对照自己的浏览器操作。浏览器商店名称商店内搜索关键词安装成本ChromeChrome 网上应用店Tampermonkey打开页面点“添加”即可FirefoxFirefox 浏览器附加组件Tampermonkey打开页面点“添加到 Firefox”即可EdgeMicrosoft Edge 加载项Tampermonkey打开页面点“获取”即可Chrome 的安装步骤打开 Chrome 网上应用店搜索 “Tampermonkey”认准开发者是 Jan Biniok 的那个结果别装错了仿冒版本。点击进入详情页后点“添加至 Chrome”浏览器弹窗确认时再点“添加扩展程序”稍等几秒右上角就会出现一个小猴子方块图标这就对了。普通用户选择稳定版即可Beta 版不需要碰稳定性差别不小。Firefox 的安装步骤进入 Firefox 浏览器附加组件页面搜索 “Tampermonkey”同样认准作者点“添加到 Firefox”再点“添加”。安装完成后Firefox 右上角会出现油猴图标。Firefox 对扩展的审核比较严格商店里的版本基本可以放心。Edge 的安装步骤Edge 现在也是 Chromium 内核操作逻辑跟 Chrome 很接近。打开 Microsoft Edge 加载项页面搜索 “Tampermonkey”点“获取”耐心等一两秒确认弹窗即可。Edge 还能直接从 Chrome 网上应用店装扩展只要在 Edge 设置里打开“允许来自其他应用商店的扩展”但既然官方加载项里就有没必要多绕一步。注意无论哪个浏览器安装完成后最好都手动固定一下图标。Chrome 里点右上角拼图图标找到 Tampermonkey点图钉按钮固定到工具栏。不固定也能用但每次要找拼图菜单体验会差很多。2.2 官方备选渠道压缩包与开发者模式安装总有遇到商店页面打不开、加载缓慢或者公司网络策略屏蔽了商店的情况。这时候可以走官方备选路径但步骤会稍微麻烦一点。第一步访问 Tampermonkey 官网 tampermonkey.net页面会自动识别你的浏览器类型给对应的安装文件。Chrome 和 Edge 拿到的通常是.crx文件Firefox 拿到的是.xpi文件。Firefox 相对省事下载.xpi文件后浏览器会弹窗询问是否添加扩展点允许即可。重点说下 Chrome 和 Edge 怎么处理.crx。新版 Chrome 早就禁止了直接把.crx拖进扩展页面的安装方式所以.crx文件要先转换一下。具体步骤如下把下载好的.crx文件重命名把后缀从.crx改成.zip。如果系统不显示后缀名先在资源管理器里开启“显示文件扩展名”。用解压软件7-Zip、WinRAR 都行把这个 zip 包解压到一个独立文件夹比如D:\Extensions\Tampermonkey。打开 Chrome在地址栏输入chrome://extensions/回车进入扩展管理页。Edge 对应的是edge://extensions/。打开页面右上角的“开发者模式”开关。点击左上角“加载已解压的扩展程序”选中刚才解压出来的文件夹确认即可。这个方法在 Firefox 上对应的是“临时加载附加组件”但临时加载的扩展在浏览器重启后会自动卸载只适合调试不适合日常使用。所以 Firefox 用户我强烈建议优先走商店实在不行再说。注意用“加载已解压的扩展程序”方式安装的油猴会有一个“开发者模式扩展”的提示而且部分浏览器版本在电脑重启后可能会弹窗提醒或自动禁用。这不是油猴的问题是浏览器对非商店来源扩展的限制。日常使用首选商店版官网压缩包只是“救急”方案。2.3 安装后第一步固定图标与基础配置装好之后先别急着找脚本先把油猴的设置按自己的习惯调一遍。点一下工具栏的油猴图标可以看到当前页面的脚本管理菜单。进去后点设置选项卡最重要的是三个选项通用里的“默认执行模式”建议保持“正常”更新里的“自动检查更新”和“自动更新已安装脚本”建议打开自动检查更新改成手动或者保持提醒都可以我一般是让油猴自动检查但更新前先看更新内容最后是“扩展是否在无痕模式下工作”这个后面讲隐私模式问题时会专门提到现在可以先了解有这个选项。顺带说一句油猴的图标在网页没有匹配脚本时是灰色的进入有脚本运行的页面才会显示角标数字这个数字代表有多少个脚本正在当前页面运行。很多新手以为灰色就是坏了其实只是没有脚本作用在你当前打开的页面上而已。3. 脚本从哪来怎么装脚本、管脚本油猴装好只是第一步真正让它发挥价值的是脚本。目前最大的用户脚本分享平台是 Greasy Fork中文支持比较友好脚本数量和更新活跃度都排得上号。这里重点讲怎么用它找到靠谱脚本以及装完之后怎么管理。3.1 脚本市场 Greasy Fork 的使用方法打开 greasyfork.org可以看到热门脚本排行榜和搜索框。我的建议是搜索时不要用“去广告”“下载视频”这种大而空的词而是用“网站名 需求”的组合比如“知乎 去广告”“B站 倍速”命中率高得多。进入脚本详情页后重点关注四个地方安装量、更新日期、代码语言和版本号、评论区。安装量高、最近一两周还在更新、评论区有真实用户反馈的脚本大概率没问题。如果一个脚本写着支持某网站但上次更新已经是两三年前那就别指望它在新版浏览器和改版后的网站上还能正常工作。详情页里“源码”按钮很重要想确认脚本有没有恶意代码必须点进去看这个后面专门讲。看到合适的脚本直接点详情页顶部的“安装此脚本”绿色按钮。油猴应收后会自动打开一个确认页显示脚本名称、来源、代码摘要和授权范围确认没问题后点“安装”。3.2 安装与管理脚本的完整操作脚本安装好之后所有管理操作都集中在油猴图标的菜单里。点击工具栏的油猴图标选择“管理面板”就能看到所有已安装脚本的列表。每一行都有启停开关、配置按钮、编辑按钮和删除菜单。这里有几个高频操作临时停用一个脚本把开关点灰即可完全移除脚本点删除需要把脚本分享给朋友在脚本详情页面点击导出生成一个.user.js文件朋友安装时只要打开这个文件的下载页面油猴就会自动识别并弹窗确认。还有一个容易忽略但很实用的功能脚本右上角的小箭头可以调整脚本在页面中的执行顺序。如果同时装了去广告和改版式两个脚本改动同一个位置时执行顺序不同结果完全不一样。遇到两个脚本冲突优先调整这个不要急着删其中一个。3.3 脚本的安全判断源码检查与权限预警这部分必须认真讲。用户脚本的能力非常强它能读取页面内容、修改页面内容、跨域发送请求、读取剪贴板、下载文件甚至跟浏览器底层交互。用一句玩笑话说脚本能做什么取决于网页能做什么。也因此恶意脚本的破坏力不容小觑。装新脚本之前尤其在 Greasy Fork 之外的地方找脚本请养成熟练点开“源码”看一眼的习惯。重点看两处第一脚本头部的// UserScript元数据块里面写了这个脚本会跑在哪些网站match以及是否申请了跨域请求权限grant GM_xmlhttpRequest。如果脚本运行范围写得非常宽比如匹配所有网站但功能只是给某个特定网站去广告这种不匹配就要警惕。第二代码里有没有指向陌生域名的网络请求。一个简单的去广告脚本理论上只需要操作当前页面的 DOM不需要把数据发到外部服务器。一旦看到没见过的域名尤其还带着GM_xmlhttpRequest或fetch先查清楚那个域名是谁的再决定装不装。筛选原则也很简单优先安装“安装量大 作者长期更新 源码完整可读”的脚本。新发布的脚本先观望看看评论区有没有人反馈异常。有人会问那知名脚本有没有可能被投毒理论上有所以尽量只从 Greasy Fork 原站安装不要安装来路不明的转载包。油猴本身也提供了一些保护机制比如在非授权页面会提示脚本请求失败但这些机制顶多算保险你自己得有安全意识。4. 进阶看懂并改脚本而不是只会用脚本用了半年油猴之后你会发现很多脚本并不是总能满足自己的奇怪需求这时候最省事的办法不是求人写脚本而是学会看懂脚本、顺手改两行。油猴脚本本质就是 JavaScript门槛并没有想象中那么高。4.1 用户脚本的基础结构一个最朴素的油猴脚本长这样// UserScript // name 页面标题加前缀示例 // namespace http://tampermonkey.net/ // version 0.1 // description 在网页标题前面加上【示例】两个字 // author YourName // match https://example.com/* // grant none // /UserScript (function() { use strict; document.title 【示例】 document.title; })();// UserScript到// /UserScript之间是脚本的元数据头油猴靠这一段决定脚本什么时候运行、运行在哪个网站、沙箱里开放哪些权限。各项要点name脚本名称显示在管理面板里。namespace命名空间用来区分同名脚本填你的个人网址或任意唯一字符串都行。version版本号更新脚本时如果版本号没变油猴可能不会提示更新。description脚本描述给自己以后看也给其他用户看。match匹配规则声明哪些网页运行这个脚本。https://example.com/*表示 example.com 域名的所有页面https://*/*表示所有 https 页面范围越宽脚本越多权限风险越大。grant授权项。none表示不需要任何特殊权限脚本只能用普通网页 JavaScript 的能力。需要跨域请求、存储配置等能力时再逐个列出grant GM_xmlhttpRequest、grant GM_setValue等。(function() { use strict; ... })();是自执行函数的常见写法把代码包在函数里避免变量污染页面里的其他脚本。4.2 一个最简单的示例与常用 GM API看懂了结构就可以自己改点小东西。比如你想在某个网站里自动点掉弹窗可以写// UserScript // name 自动关弹窗 // match https://example.com/* // grant none // /UserScript (function() { use strict; function closePopup() { const btn document.querySelector(.popup-close); if (btn) btn.click(); } // 页面刚加载时执行一次之后每隔一秒检查一次 closePopup(); setInterval(closePopup, 1000); })();这段代码做的事很直观在当前页面里找一个类名为popup-close的元素找到就点掉它。setInterval是为了应付那些延迟出现的弹窗。注意选择器.popup-close要按目标网站实际的 HTML 结构来写不同网站类名完全不同。常用 GM API 也整理一下按用途分类GM_setValue/GM_getValue在浏览器本地保存和读取脚本配置存一些开关、默认值之类的小数据。GM_addStyle往页面里注入 CSS 样式用来隐藏广告位、调整布局、改主题色比用 JavaScript 一个个改样式高效得多。GM_xmlhttpRequest跨域请求。普通页面 JavaScript 受同源策略限制无法请求其他域名接口油猴脚本有了这个接口就能绕过这层限制去请求指定接口是一些带数据同步功能脚本的基础。GM_registerMenuCommand在油猴菜单里注册一个自定义命令点一下执行一段逻辑适合做“手动触发下载”这类交互。入门阶段认识这几个就够用了。写脚本的时候不要贪多先从“加一行样式”“改个标题”“自动点击一个按钮”开始改出成就感之后自然会慢慢理解更多 API。注意grant不能乱写。你用到了GM_setValue就必须在头部写grant GM_setValue否则脚本会报GM_setValue is not defined。反过来如果脚本完全不需要特殊权限写grant none就好写得越少权限面越小越安全。4.3 常见功能的实现思路视频下载、去水印、自动化操作每次油猴教程下面都有人问视频下载脚本和去水印脚本怎么写的说实话这两类脚本的思路跟“改个标题”不是一个量级但了解思路有助于你判断某个脚本是不是值得信任。先说视频下载主流做法有三种。第一种是“嗅探请求”监听页面发出的网络请求找出后缀是.mp4、.m3u8或通过关键词能判断是视频流的请求然后提供下载按钮。这种方法不关心网站具体怎么播放只要视频确实是浏览器加载过的就有机会抓到。第二种是“调用接口”网站播放器通常有一个视频源地址接口脚本模拟请求拿到地址再下载网站一改接口就会失效。第三种是“解析批处理”针对某些视频网站的会员压制、多分片等复杂情况脚本需要组合多个请求来拼出完整视频技术难度最高。再说去水印很多平台的“水印”其实分两种。如果是播放器叠加在视频画面上的水印文字脚本可以尝试找到播放器参数里控制水印的开关字段把字段值改掉如果水印已经“烙”进视频编码里那脚本就不可能有办法去掉。有人可能会动“下载无水印原片”的脑筋这往往是绕过平台鉴权风险我建议碰都不要碰。另外不少热词里提到的“VBA 通过 CDP 操控 Chrome”“浏览器网页表单抓取”等需求严格来说不是油猴的核心场景。油猴解决的是“页面内部逻辑”要操控浏览器本身的标签页、下载目录、打印行为应该用官方扩展接口或自动化测试工具比如 Playwright、Puppeteer。分清工具边界能省下大量折腾时间。5. 常见问题与排查技巧实录用了这么多年油猴我踩过的坑比看过的教程还多。下面把最常见的十几个问题整理成速查表每条都附上我的排查思路而不是直接甩一个“重装”的粗暴方案。5.1 典型问题速查表问题现象大概率原因解决方式商店里搜索不到 Tampermonkey地区策略或商店版本过滤换官方商店语言为英文再搜或者走官网下载渠道点击“添加扩展程序”没反应浏览器缓存问题或商店页面加载异常刷新商店页面后重试清除浏览器缓存重启浏览器Chrome 提示“无法添加扩展程序”浏览器版本过旧或系统策略限制先升级浏览器公司电脑检查是否被 IT 策略锁死拖拽.crx文件安装失败新版 Chrome 禁止拖拽 crx改用开发者模式加载解压后的文件夹油猴图标是灰色的当前页面没有匹配的脚本换一个脚本匹配的网站测试或检查match规则脚本装了但不生效match没匹配上 / 脚本本身过时先看控制台有无报错再检查脚本是否已更新到最新版脚本只第一次生效刷新后失效网站内容动态加载脚本执行时机太早改用run-at document-idle或加定时器/MutationObserver隐私模式下油猴不运行扩展未允许在无痕模式下启用Chrome 扩展详情页打开“在无痕模式下启用”Firefox 在扩展首选项里勾选脚本里出现弹窗广告装到了不干净脚本立即停用并删除该脚本检查是否还有它自动注入的其他脚本视频下载脚本突然不能用了网站播放器改版脚本接口失效清缓存、更新脚本、看 Greasy Fork 评论区有没有替代脚本网页布局错乱、按钮消失油猴脚本跟页面改版或跟其他脚本冲突逐个禁用脚本排查调整脚本执行顺序Chrome 内容过曝和油猴没有关系多半是系统色彩管理或显卡驱动问题检查显示器 HDR、对比度设置更新显卡驱动表格能覆盖大部分情况但有几个问题我想拿出来单独强调因为它们太容易被误判成油猴故障了。5.2 被误解的“浏览器插件”难题业务控件与自动化工具有些用户在公司内网办公打开 OA 系统跳出提示“尚未安装 ntko web chrome 跨浏览器插件”或“请安装浏览器控件”第一反应是“装个油猴插件解决它”。这是个典型的误解。这类提示说的是单位办公系统要求的专用 Web 控件通常需要从单位 OA 门户或系统管理员提供的安装包渠道安装跟油猴完全不在一个赛道。油猴脚本不能代替这类浏览器控件就像你不能用一个 App 商店里的应用去激活另一个 App 的会员。正确的做法是先看提示页面上有没有提供安装包下载入口或者问一下单位 IT 部门要官方安装文件和安装说明。涉及 U 盾、加密狗、加密控件的更要谨慎这些组件往往要配合专门的浏览器版本或安全配置别图省事乱装来源不明的“兼容补丁”。另一个热词是“Codex 第三方 API 不能用浏览器插件”。这类问题的关键在于浏览器插件和外部程序的 API 认证机制是两套体系。第三方应用连不上某个服务的 API通常要去服务商控制台检查密钥、回调地址和白名单配置而不是在浏览器端装扩展。油猴也好、普通浏览器扩展也好能干预的只是网页请求的注入与修改改不了服务端对 API 密钥的校验规则。排查思路清晰一点能节省大量时间。注意判断“是不是油猴的问题”我有一套四步法先禁用全部油猴脚本刷新页面问题还在的话说明和油猴无关再单独启用一个脚本逐个试能定位到具体脚本再看浏览器控制台F12有没有红色报错能看清脚本执行到哪一步失败最后才考虑升级或替换脚本。不要一上来就卸载重装那样只能解决“不会用”的问题解决不了“用坏了”的问题。5.3 油猴脚本的日常保养更新、备份、清理最后聊一个很少有人提但很实际的问题脚本的日常保养。用户脚本不是装完就一劳永逸的网站会改版脚本需要更新浏览器会升级脚本可能不兼容脚本越装越多互相冲突的概率也会上升。我的习惯有三个。第一每隔一两周打开管理面板看看哪些脚本提示有更新更新前先点开看看版本变化和评论区反馈。大版本更新如果很多人说新版本有问题就先停用等修复版。第二把常用的脚本定期导出备份尤其那些你自己改过代码的脚本备份文件放本地一个固定文件夹里。浏览器重装、换电脑时直接从备份恢复能省下大量重新找脚本的时间。第三定期清理脚本列表。超过一个月没用到、页面已经不兼容、功能被网站原生替代的脚本果断删掉。脚本数量越少页面性能负担越小安全隐患也越小。根据我自己的经验装了几十个脚本之后页面加载速度肉眼可见地变慢尤其是那些在document-start阶段就执行的脚本每个都会拖慢首屏渲染。把不用的脚本停用效果立竿见影。这个内容后续还可以扩展的方向其实很多比如学习怎么写match规则来精准控制脚本范围、用GM_xmlhttpRequest实现网页数据导出、用 MutationObserver 处理动态页面。油猴的价值不在于它替你干了多少事而在于它给了你把浏览器改造得趁手的自由。先把下载、安装、使用这条主流程跑通配上甄别脚本的能力你已经比大多数只会点“安装”的玩家强出一截了。