Chrome插件开发文档

本页面提供 Chrome 浏览器插件（扩展）开发的基础知识、核心概念和实用技巧，适合初学者快速入门，也方便开发者查阅关键信息。

1. 什么是 Chrome 插件？

Chrome 插件（Extension）是用于增强浏览器功能的小型软件程序。它可以修改网页内容、添加工具栏按钮、拦截网络请求、管理书签等。

2. 基础结构

一个最简单的 Chrome 插件至少包含以下两个文件：

• manifest.json：插件的配置清单文件，定义插件名称、版本、权限、入口等。
• 至少一个 HTML/JS/CSS 文件（如 popup.html 或 content.js）。

3. manifest.json 示例

{
  "manifest_version": 3,
  "name": "我的第一个插件",
  "version": "1.0",
  "description": "一个简单的 Chrome 插件示例",
  "action": {
    "default_popup": "popup.html"
  },
  "permissions": ["activeTab"]
}

4. 核心概念

• Manifest V3：当前推荐使用的插件架构，强调安全性与性能。
• Content Scripts：注入到网页中的脚本，可操作 DOM。
• Background Service Worker：替代旧版后台页，用于长期监听事件（V3 中为非持久化）。
• Popup / Options 页面：用户交互界面。
• Permissions：声明所需权限（如访问标签页、存储、网络等）。

5. 调试方法

• 打开 chrome://extensions/
• 开启“开发者模式”
• 点击“加载已解压的扩展程序”选择你的插件目录
• 点击插件详情中的“检查视图”可调试 popup 或 background 脚本

6. 学习资源推荐

官方文档是最权威的学习资料：Chrome Extensions 官方文档