Chrome 扩展程序上架指南

Chrome 扩展程序上架 Google Web Store 完整指南

📌 引言

Chrome Web Store 是 Google 官方的浏览器扩展程序分发平台，拥有超过 2 亿活跃用户。本文将详细介绍如何将你的 Chrome 扩展程序从开发到正式上架的完整流程，包括开发者账号注册、资料准备、上传配置、审核要点等关键步骤。

📋 目录

前期准备
[注册 Google 开发者账号](#注册 Google 开发者账号)
准备上架材料
创建扩展程序项目
填写商店信息
上传扩展程序包
隐私政策与合规性
提交审核
审核流程与常见问题
发布与更新
总结

1. 前期准备

1.1 开发环境检查

在上架前，确保你的扩展程序：

✅ 使用 Manifest V3 格式（Manifest V2 已逐步废弃）
✅ 在本地测试通过（chrome://extensions/ 开发者模式）
✅ 功能完整，无明显 Bug
✅ 符合 Chrome Web Store 的开发者政策

1.2 必备材料清单

Google 账号（用于注册开发者）
5 美元注册费（一次性费用）
扩展程序的 dist 打包文件（ZIP 格式）
推广图片素材（多种尺寸）
隐私政策文档（如有数据收集）

2. 注册 Google 开发者账号

2.1 访问开发者控制台

打开 Chrome Web Store Developer Dashboard
使用你的 Google 账号登录

2.2 支付注册费

费用：5 美元（一次性）
支付方式：(推荐使用虚拟卡) 信用卡或借记卡（支持 Visa、MasterCard、American Express）
注意：费用不可退还，但账号永久有效

2.3 验证开发者身份

填写开发者信息（姓名、邮箱、网站等）
同意开发者协议
完成邮箱验证

提示：建议使用公司邮箱或域名邮箱，增加可信度。

3. 准备上架材料

3.1 打包扩展程序

方式 1：手动打包

bash 复制代码

# 进入项目根目录
cd your-extension-project

# 使用命令行打包（如果使用构建工具）
npm run build

# 创建 ZIP 压缩包
cd dist
zip -r extension.zip *

方式 2：Chrome 自动打包

打开 chrome://extensions/
开启"开发者模式"
点击"打包扩展程序"
选择扩展程序根目录
生成 .crx 文件（需转换为 .zip）

注意事项：

✅ 只打包 dist 目录（不包含源代码、node_modules、.git 等）
✅ 确保 manifest.json 在 ZIP 根目录
✅ 文件大小建议 < 10MB

3.2 准备推广素材

Google Web Store 要求提供以下尺寸的图片：

图片类型	尺寸要求	数量	是否必须
小图标	128x128 px	1 张	✅ 必须
商店图标	440x280 px	1 张	✅ 必须
宣传图片	1400x560 px	1 张	✅ 必须
截图	1280x800 px 或 640x400 px	1-5 张	✅ 必须
宣传视频	YouTube 链接	1 个	❌ 可选

图片要求：

格式：PNG 或 JPEG
背景：透明或纯色
内容：展示扩展程序的核心功能
禁止：模糊、拉伸、误导性内容

3.3 撰写商店文案

扩展程序名称

长度：最多 45 个字符
要求：简洁、描述性、包含关键词
示例：Price Converter - Real-time Exchange Rates

简短描述

长度：最多 132 个字符
要求：一句话说明核心功能
示例：Automaticallyprices to USD, EUR, GBP with real-time exchange rates and markup calculator.

详细描述

长度：建议 200-1000 字

结构建议：

复制代码

- 核心功能介绍（2-3 句）
- 主要特性列表（bullet points）
- 使用场景说明
- 技术优势
- 联系方式/反馈渠道

4. 创建扩展程序项目

4.1 进入开发者控制台

访问 Chrome Web Store Developer Dashboard

4.2 创建新项目

点击 "新增项目" 按钮
上传准备好的 ZIP 文件
等待系统自动解析 manifest.json

4.3 自动检查

系统会自动检查：

✅ manifest.json 格式是否正确
✅ 权限声明是否合理
✅ 图标文件是否存在
✅ 是否包含恶意代码

常见错误：

❌ manifest.json 不在根目录
❌ 使用了废弃的 API
❌ 权限声明过多或不明确

5. 填写商店信息

5.1 商店列表信息

基本信息

类别：选择最相关的分类（如"购物"、"生产力"、"开发者工具"等）
语言：选择主要语言（支持多语言版本）

可见性设置

公开：所有人可见和安装
不公开：仅通过链接访问（不在搜索结果中显示）
私有：仅特定用户可访问（需配置白名单）

5.2 上传推广素材

按照要求上传：

商店图标（440x280 px）
宣传图片（1400x560 px）
截图（至少 1 张，建议 3-5 张）

技巧：

截图应展示核心功能流程
可添加文字说明（但不要覆盖主要内容）
使用高对比度背景，便于用户识别

5.3 填写文案

扩展程序名称（45 字符以内）
简短描述（132 字符以内）
详细描述（支持富文本格式）

SEO 优化建议：

在名称和描述中自然融入关键词
使用标题标签（#）和列表（-）提高可读性
提供使用示例和常见问题解答

6. 上传扩展程序包

6.1 上传 ZIP 文件

在"包"选项卡中，点击 "上传新包"
选择你的 extension.zip 文件
等待上传完成（通常 10-30 秒）

6.2 版本管理

每次上传新版本时，必须更新 manifest.json 中的版本号：

json 复制代码

{
  "manifest_version": 3,
  "name": "My Extension",
  "version": "1.0.1",  // ← 必须递增
  ...
}

版本号规则：

格式：主版本.次版本.修订号（如 1.2.3）
要求：新版本号必须大于旧版本
示例：1.0.0 → 1.0.1 → 1.1.0 → 2.0.0

如果你的应用提交审核是灰色的

保存草稿点击左边的?号打开弹窗后会显示你哪些资料没有补充完整

7. 隐私政策与合规性

7.1 何时需要隐私政策？

如果你的扩展程序符合以下任一条件，必须提供隐私政策：

✅ 收集用户数据（如浏览历史、表单输入、位置信息）
✅ 使用 storage API 存储用户设置
✅ 向第三方服务器发送数据
✅ 使用 cookies 或本地存储
✅ 请求敏感权限（如 tabs, webRequest, cookies）

7.2 隐私政策内容要求

必须包含：

收集的数据类型（如价格信息、用户设置）
数据用途（如提供汇率转换、保存用户偏好）
数据存储位置（本地 / 云端）
第三方服务（如使用了哪些 API）
数据保护措施（加密、匿名化等）
用户权利（如何删除数据、联系方式）

7.3 隐私政策托管

你需要将隐私政策托管在：

✅ 你的官方网站（推荐）
✅ GitHub Pages
✅ Google Docs（设置为公开可见）

示例隐私政策模板：

markdown 复制代码

# 隐私政策

最后更新日期：2026-01-13

## 数据收集
本扩展程序不收集任何个人身份信息。仅在本地存储以下数据：


## 数据使用
- 汇率数据：通过api.com 公开 API 获取，不传输任何用户信息
- 本地存储：使用 Chrome Storage API 仅保存在您的设备上

## 第三方服务
- Exchange Rate API (https://www.exchangerate-api.com/)

## 联系方式
如有疑问，请联系：your-email@example.com

7.4 权限声明

在商店页面的"隐私权实践"部分，必须逐一说明每个权限的用途：

权限	说明示例
`storage`	保存用户的货币偏好和汇率缓存
`tabs`	检测当前访问的网站以注入价格转换功能
`contextMenus`	添加右键菜单以快速搜索图片
`activeTab`	在用户激活扩展时访问当前页面内容

8. 提交审核

8.1 审核前检查清单

在点击"提交审核"前，确保：

✅ 所有必填信息已完整填写
✅ 上传的 ZIP 文件通过了自动检查
✅ 推广素材符合尺寸要求
✅ 隐私政策链接有效且内容完整
✅ 权限声明合理且有说明
✅ 详细描述清晰准确，无误导内容

8.2 提交流程

在开发者控制台，点击 "提交审核" 按钮
确认所有信息无误
点击 "提交发布"

8.3 审核状态

提交后，你可以在控制台查看审核状态：

状态	说明	预计时长
待审核	已进入审核队列	1-3 个工作日
审核中	Google 正在审核	-
需要修改	发现问题，需修改后重新提交	-
已批准	审核通过，扩展已发布	-
已拒绝	违反政策，无法发布	-

9. 审核流程与常见问题

9.1 审核重点

Google 会重点检查：

功能性：扩展是否按描述正常工作
安全性：是否包含恶意代码、是否过度请求权限
隐私合规：数据收集是否透明、隐私政策是否完整
内容质量：描述是否准确、截图是否真实
政策合规：是否违反开发者政策（如垃圾内容、欺诈行为）

9.2 常见拒绝原因

1. 权限请求不合理

问题：请求了不必要的权限（如 <all_urls> 但只在特定网站使用）
解决：精确声明 host_permissions，只请求必需权限

2. 隐私政策缺失或不完整

问题：使用了 storage 但未提供隐私政策
解决：添加详细的隐私政策并在商店页面填写链接

3. 功能描述与实际不符

问题：承诺了"免费"但实际需要付费
解决：确保描述准确，不夸大宣传

4. 包含混淆代码

问题：使用了代码混淆工具，Google 无法审查
解决：提交源代码或使用可读的构建输出

5. 截图质量差或误导

问题：截图模糊、包含其他产品信息
解决：使用高清截图，只展示自己的扩展功能

9.3 申诉流程

如果认为审核结果有误：

在开发者控制台查看拒绝原因
点击 "申诉" 按钮
详细说明你的情况，提供证据
等待人工审核（通常 3-7 个工作日）

10. 发布与更新

10.1 发布后的操作

审核通过后，扩展会自动发布到 Chrome Web Store：

🌐 商店链接 ：https://chrome.google.com/webstore/detail/[你的扩展ID]
📈 安装统计：可在开发者控制台查看每日安装量、评分等
💬 用户反馈 ：用户可以留言和评分

10.2 更新扩展

发布新版本的流程：

修改本地代码
更新 manifest.json 中的版本号
重新打包 ZIP 文件
在开发者控制台上传新包
提交审核

注意：

✅ 小更新（Bug 修复）：通常 1 天内通过
✅ 大更新（新增权限、功能）：可能需要 2-3 天审核

10.3 自动更新机制

用户端的扩展会自动更新：

Chrome 每隔几小时检查一次更新
用户无需手动操作
可在 chrome://extensions/ 手动点击"更新"

11. 常见问题 FAQ

Q1: 审核需要多久？

A: 通常 1-3 个工作日。高峰期可能延长至 5-7 天。

Q2: 可以先发布"测试版"吗？

A: 可以。将可见性设置为"不公开"，只分享链接给测试用户。

Q3: 如何处理负面评价？

A: 礼貌回复用户，了解问题并修复。积极的沟通可以改善评分。

Q4: 是否支持退款？

A: 5 美元注册费不支持退款，但账号永久有效，可发布多个扩展(20-30个左右吧)。

Q5: 扩展被拒绝后还能重新提交吗？

A: 可以。根据拒绝原因修改后，可以无限次重新提交。

需要注意的点

这里的邮箱不要用显示隐私信息的邮箱应用发布后会在产品页面显示

例如：手机号、qq号等等 - 错误示例：1573377****qq.com

📊 总结

Chrome 扩展程序上架流程可以总结为以下关键步骤：

✅ 核心流程

注册开发者账号（5 美元，一次性）
打包扩展程序 （ZIP 格式，包含 manifest.json）
准备推广素材（图标、截图、宣传图片）
撰写商店文案（名称、描述、功能列表）
配置隐私政策（如有数据收集）
提交审核（1-3 工作日）
审核通过后自动发布

🔑 成功要点

✅ 权限最小化：只请求必要的权限(审核快)
✅ 隐私透明：明确说明数据使用方式
✅ 描述准确：不夸大、不误导
✅ 素材优质：高清截图、清晰文案
✅ 代码规范：使用 Manifest V3，避免混淆

📈 上架后的运营

📊 定期查看安装量和评分
💬 及时回复用户反馈
🔧 快速修复 Bug 并推送更新
📣 通过社交媒体、博客推广

🌟 额外建议

建议在本地和朋友圈充分测试后再上架
准备多语言版本可以扩大用户群
关注 Chrome Developers Blog 了解最新政策

📚 参考资源

官方文档 ：Chrome Web Store Developer Documentation
政策指南 ：Chrome Web Store Program Policies
Manifest V3 迁移指南 ：Migrate to Manifest V3
开发者控制台 ：Chrome Web Store Dashboard

祝你的扩展程序上架顺利！🎉

如有问题，欢迎在评论区留言讨论。

本文最后更新于 2026 年 1 月，基于最新的 Chrome Web Store 政策编写。