如何制作一个油猴插件（Tampermonkey）

原创于 2025-08-15 10:06:53 发布 · 492 阅读

3 ·

CC 4.0 BY-SA版权

文章标签：

#javascript #油猴插件 #Tampermonkey

制作油猴（Tampermonkey）插件其实并不复杂，它本质上是一个包含特定元数据的 JavaScript 脚本。

以下是一个示例：

// ==UserScript==
// @name         示例油猴插件
// @namespace    http://tampermonkey.net/
// @version      0.1
// @description  这是一个简单的油猴插件示例，用于演示基本功能
// @author       你的名字
// @match        https://www.example.com/*
// @grant        none
// ==/UserScript==

(function() {
    'use strict';

    // 插件的主要功能代码
    console.log('油猴插件已运行！');

    // 修改页面标题
    document.title = '【已被油猴插件修改】' + document.title;

    // 修改页面背景色
    document.body.style.backgroundColor = '#f0f8ff';

    // 添加一个提示框
    const alertDiv = document.createElement('div');
    alertDiv.style.position = 'fixed';
    alertDiv.style.top = '20px';
    alertDiv.style.right = '20px';
    alertDiv.style.padding = '10px 20px';
    alertDiv.style.backgroundColor = '#4CAF50';
    alertDiv.style.color = 'white';
    alertDiv.style.borderRadius = '5px';
    alertDiv.style.zIndex = '9999';
    alertDiv.textContent = '油猴插件已生效！';
    document.body.appendChild(alertDiv);

    // 3秒后自动移除提示框
    setTimeout(() => {
        alertDiv.style.opacity = '0';
        alertDiv.style.transition = 'opacity 0.5s';
        setTimeout(() => alertDiv.remove(), 500);
    }, 3000);
})();

油猴插件的基本结构解析

元数据块（Metadata Block）：
这部分以// ==UserScript==开始，// ==/UserScript==结束，包含插件的基本信息：
- @name：插件名称
- @namespace：通常使用个人域名或固定值
- @version：版本号
- @description：插件描述
- @author：作者名称
- @match：指定插件生效的网址，支持通配符
- @grant：声明需要的特殊权限，none表示不需要额外权限
执行代码：
通常包裹在一个自执行匿名函数中，使用'use strict'开启严格模式，避免变量污染。