巧记助手
巧记助手
返回博客列表
技术教程

Chrome 插件开发实战：打造你的第一个浏览器扩展

巧记团队•2025-11-09•12 分钟阅读
#Chrome 插件#JavaScript#Web 开发
🔧

从零开始，打造属于你的 Chrome 插件

引言：为什么要开发 Chrome 插件？

Chrome 插件（Chrome Extension）是运行在浏览器中的小程序，可以增强浏览器功能、提升工作效率。全球有超过 2 亿用户在使用各种 Chrome 插件。

开发 Chrome 插件的优势：

  • 低门槛：只需要 HTML、CSS、JavaScript 基础
  • 广泛应用：可以在任何网页上运行
  • 快速迭代：开发周期短，易于更新
  • 商业价值：可以通过 Chrome 网上应用店分发和变现

第一步：理解 Chrome 插件架构

核心组件

📄 Manifest 文件

插件的配置文件，定义插件的名称、版本、权限等信息。

🎨 Popup 页面

点击插件图标时弹出的页面，通常用于展示主要功能。

📝 Content Scripts

注入到网页中的脚本，可以读取和修改网页内容。

⚙️ Background Scripts

在后台运行的脚本，处理事件监听、数据存储等任务。

第二步：创建你的第一个插件

项目结构

my-extension/
├── manifest.json       # 配置文件
├── popup.html          # 弹出页面
├── popup.js            # 弹出页面脚本
├── content.js          # 内容脚本
├── background.js       # 后台脚本
├── styles.css          # 样式文件
└── icons/              # 图标文件夹
    ├── icon16.png
    ├── icon48.png
    └── icon128.png

1. 创建 manifest.json

这是插件的核心配置文件。从 2023 年起，Chrome 要求使用 Manifest V3。

{
  "manifest_version": 3,
  "name": "我的第一个插件",
  "version": "1.0.0",
  "description": "这是一个示例 Chrome 插件",
  "icons": {
    "16": "icons/icon16.png",
    "48": "icons/icon48.png",
    "128": "icons/icon128.png"
  },
  "action": {
    "default_popup": "popup.html",
    "default_icon": "icons/icon48.png"
  },
  "permissions": [
    "storage",
    "activeTab"
  ],
  "content_scripts": [
    {
      "matches": ["<all_urls>"],
      "js": ["content.js"]
    }
  ],
  "background": {
    "service_worker": "background.js"
  }
}

2. 创建 Popup 页面

popup.html - 用户界面：

<!DOCTYPE html>
<html>
<head>
  <meta charset="UTF-8">
  <link rel="stylesheet" href="styles.css">
</head>
<body>
  <div class="container">
    <h1>我的插件</h1>
    <button id="actionBtn">点击我</button>
    <p id="result"></p>
  </div>
  <script src="popup.js"></script>
</body>
</html>

popup.js - 交互逻辑：

document.getElementById('actionBtn').addEventListener('click', async () => {
  // 获取当前标签页
  const [tab] = await chrome.tabs.query({ active: true, currentWindow: true });
  
  // 向 content script 发送消息
  chrome.tabs.sendMessage(tab.id, { action: 'highlight' }, (response) => {
    document.getElementById('result').textContent = response.message;
  });
});

3. 创建 Content Script

Content Script 可以访问和修改网页内容：

// content.js
chrome.runtime.onMessage.addListener((request, sender, sendResponse) => {
  if (request.action === 'highlight') {
    // 高亮页面中的所有链接
    const links = document.querySelectorAll('a');
    links.forEach(link => {
      link.style.backgroundColor = 'yellow';
    });
    
    sendResponse({ message: `已高亮 ${links.length} 个链接` });
  }
  return true; // 保持消息通道开启
});

4. 创建 Background Script

Background Script 在后台运行，处理事件和数据：

// background.js
chrome.runtime.onInstalled.addListener(() => {
  console.log('插件已安装');
  
  // 设置默认配置
  chrome.storage.sync.set({ enabled: true });
});

// 监听标签页更新
chrome.tabs.onUpdated.addListener((tabId, changeInfo, tab) => {
  if (changeInfo.status === 'complete') {
    console.log('页面加载完成:', tab.url);
  }
});

第三步：加载和测试插件

📦 加载步骤

  1. 打开 Chrome 浏览器，访问 chrome://extensions/
  2. 开启右上角的"开发者模式"
  3. 点击"加载已解压的扩展程序"
  4. 选择你的插件文件夹
  5. 插件加载成功！点击图标测试功能

第四步：常用 API 和功能

存储数据

// 保存数据
chrome.storage.sync.set({ key: 'value' }, () => {
  console.log('数据已保存');
});

// 读取数据
chrome.storage.sync.get(['key'], (result) => {
  console.log('读取到:', result.key);
});

标签页操作

// 创建新标签页
chrome.tabs.create({ url: 'https://example.com' });

// 获取当前标签页
chrome.tabs.query({ active: true, currentWindow: true }, (tabs) => {
  console.log('当前页面:', tabs[0].url);
});

// 关闭标签页
chrome.tabs.remove(tabId);

右键菜单

// 创建右键菜单
chrome.contextMenus.create({
  id: 'myMenu',
  title: '使用我的插件',
  contexts: ['selection']
});

// 监听菜单点击
chrome.contextMenus.onClicked.addListener((info, tab) => {
  console.log('选中的文本:', info.selectionText);
});

第五步：发布到 Chrome 网上应用店

  1. 准备发布材料
    • 插件图标（128x128）
    • 宣传图片（1280x800 或 640x400）
    • 详细描述和截图
  2. 打包插件

    在 chrome://extensions/ 点击"打包扩展程序"

  3. 注册开发者账号

    访问 Chrome Web Store Developer Dashboard，支付 $5 注册费

  4. 上传并提交审核

    填写插件信息，上传 .zip 文件，提交审核（通常 1-3 天）

最佳实践和技巧

✅ 性能优化

  • • 最小化 Content Script 的执行范围
  • • 使用事件驱动而非轮询
  • • 延迟加载非关键资源

🔒 安全建议

  • • 只请求必要的权限
  • • 验证和清理用户输入
  • • 使用 HTTPS 进行网络请求

📱 用户体验

  • • 提供清晰的图标和界面
  • • 添加快捷键支持
  • • 提供详细的帮助文档

结语

恭喜你！现在你已经掌握了 Chrome 插件开发的基础知识。从简单的功能开始，逐步探索更复杂的应用场景。

巧记助手就是一个功能丰富的 Chrome 插件，集成了 AI 题目解析、智能笔记管理等功能。你可以参考我们的实现，打造属于你自己的插件！

想看更多实战案例？

安装巧记助手，体验专业级 Chrome 插件的功能

免费安装