1选择扩展类型与版本
在页面顶部选择扩展预设模式:最小配置(Minimal)适合简单工具,页面修改(Content Script)适合页面增强,全功能(Full)包含所有组件。然后选择 Manifest 版本,推荐新项目使用 V3 版本,V2 已于 2025 年逐步淘汰。版本选择会影响后续可配置的组件类型和权限字段。
2填写扩展基本信息
在基本信息区域填写扩展名称(必填,2-45个字符,建议使用英文名称避免商店兼容性问题)、版本号(格式如 1.0.0,遵循语义化版本规范)、默认语言(选择中文、英文、繁体中文或日文)、详细描述(显示在浏览器商店的扩展详情页)和作者信息。描述应简洁说明扩展的核心功能和使用场景。
3配置权限与组件
在权限区域勾选扩展所需的 API 权限,工具会根据已启用的组件自动推荐必要权限。建议遵循最小权限原则,仅申请功能必需的权限,过多权限会导致商店审核失败。然后启用需要的组件:Background 后台脚本选择运行类型(Service Worker 或 Event Page)、Content Script 配置 URL 匹配模式、Popup 设置标题和内容、Options 启用设置页面。
4自定义组件代码
每个启用的组件都提供自定义代码输入区域。Background 区域可编写后台逻辑代码,Content Script 区域可编写页面操作代码,Popup 区域可自定义 HTML 结构和 JavaScript 交互逻辑。如果暂时不需要自定义代码,工具会生成包含基本模板的默认文件,开发者可以后续再进行修改和完善。
5预览生成代码
在右侧代码预览区通过文件切换按钮查看 manifest.json、background.js、content.js、popup.html、popup.js、options.html 等文件的生成结果。代码变更与左侧表单配置实时同步,开发者可以直观看到每个配置项对最终代码的影响。如果发现配置不正确,可随时返回左侧表单调整,无需刷新页面。
6导出项目文件
确认配置和代码无误后,选择合适的导出方式:点击「复制」按钮将当前预览文件的代码复制到剪贴板,适合快速粘贴到现有项目中;点击「下载 ZIP」获取完整项目包,包含所有生成文件和正确的目录结构,解压后即可使用;点击「下载 manifest.json」单独获取配置文件。ZIP 包可直接用于本地开发环境。
7加载并调试扩展
打开 Chrome 浏览器,访问 chrome://extensions/,开启右上角的「开发者模式」开关,点击「加载已解压的扩展」按钮选择解压后的项目目录。扩展加载成功后会出现在列表中。通过右键点击扩展图标选择「检查」打开 Popup 调试窗口;Background 的 Service Worker 可通过扩展详情页的「检查视图」链接打开独立控制台;Content Script 的日志在网页控制台中查看。
8发布到浏览器商店
开发测试完成后,将项目目录打包为 ZIP 文件(确保 manifest.json 在 ZIP 根目录)。登录 Chrome 开发者控制台注册开发者账号(需支付一次性注册费约 5 美元),点击「新建商品」上传 ZIP 包,填写商品名称、描述、至少一张 1280x800 像素的宣传截图和隐私政策链接,选择目标发布地区后提交审核。审核通常需要 1-3 个工作日,通过后扩展即可在 Chrome Web Store 上架。
UD5工具箱