Chrome扩展怎么写?从本地加载开始

更新时间:2026-10-26 11:36

写Chrome扩展,先建立一个项目文件夹,并在根目录放入manifest.json。打开chrome://extensions,启用开发者模式,选择【加载已解压的扩展程序】并选中这个文件夹。扩展卡片出现在管理页,说明Chrome已读取项目。

Chrome扩展从manifest.json开始

manifest.json描述扩展的名称、版本、权限和要运行的资源。新项目使用Manifest V3,并把每个文件路径写成相对项目根目录的路径。工具栏入口由action中的弹出页声明。网页内容修改功能由内容脚本和匹配站点声明。

1、建立根目录和清单

创建独立目录,例如my-extension。manifest.json必须位于根目录,不能放在更深的子目录。一个只用于验证加载的清单可先包含manifest_version、name、version和action,功能稳定后再加入权限、图标或后台逻辑。

2、添加弹出页和脚本

创建popup.html和popup.js。弹出页负责展示按钮、输入框或状态文字,脚本负责响应点击。先让按钮在弹出页内更新文本,确认文件关联正确,再加入标签页、存储或网络访问能力。

Chrome扩展怎么写?从本地加载开始

加载已解压的扩展程序

进入chrome://extensions,打开页面右上角的开发者模式。点击【加载已解压的扩展程序】,选择项目根目录。管理页会显示扩展名称、版本和控制开关。工具栏没有图标,可从扩展菜单将它固定到工具栏。

Chrome扩展怎么写?从本地加载开始

加载成功只是第一步。点击工具栏图标,检查popup是否能打开,按钮是否有反馈。扩展首次加载、浏览器重启和更新文件后的表现都应分别测试。

Chrome扩展怎么写?从本地加载开始

修改代码后重载并查看错误

编辑manifest、脚本或页面文件,回到扩展管理页点击重载图标。Chrome才会使用新的项目文件。已经打开的弹出页需要关闭并重新打开,避免把旧页面当成新结果。

Chrome扩展怎么写?从本地加载开始

扩展卡片出现【错误】按钮,打开它查看文件名、行号和报错信息。JSON少逗号、引号未闭合、路径拼错或权限遗漏都会阻止扩展运行。弹出页的交互问题可在弹出页中打开开发者工具检查控制台输出。

Chrome扩展怎么写?从本地加载开始

功能拆分和权限控制

功能适合的位置
工具栏小窗口action与popup页面
改变网页内容content script
保存用户选项扩展存储与选项页
菜单和消息协调service worker

权限只申请功能真正需要的范围。访问网页应限制匹配站点。发布前检查名称、描述、图标和实际行为是否一致。这样既方便后续维护,也能减少用户安装时对权限的疑虑。