上架 Chrome 应用商店：注册、打包、提审全流程

一句话目标：把你在上一课跑通的本地扩展发布出去——走完 chrome 插件上架的「注册开发者账号 → 打包上传 → 提交审核」三步，进入 Chrome 应用商店的审核队列，让陌生用户能搜到、安装你的插件。

学完你能做什么

• 注册一个 Chrome Web Store 开发者账号，进得了开发者后台
• 把扩展目录打包成 manifest.json 位于根目录的合规 zip
• 在后台填完 5 个标签页的商品信息
• 点下 Submit for Review，让扩展进入商店的审核队列

你现在的困境

• 「插件是跑起来了，可它只活在我自己的浏览器里。朋友想要，我只能远程教他开开发者模式、手动加载文件夹。」
• 「听说上架要交钱、要审核，但具体分几步、每步要准备什么材料，完全没概念。」
• 「最怕信息填错：账号邮箱要是写错了，这个号是不是就废了？」

什么时候用这一招

当你需要：把扩展分发给陌生人——任何人都能在 Chrome 应用商店搜到你的插件、一键安装，不用你一个个发文件。

而且不想：远程教朋友开开发者模式手动加载；或者让插件永远只装在自己电脑上。

🎒 开始前的准备

• 已完成前置课《第一个 Chrome 插件：15 分钟跑通 Hello World》，扩展能在浏览器里正常加载、功能都跑得通——官方文档也强调上传前先在本地把功能测一遍。
• 一个想清楚再用的 Google 账号：开发者账号绑定的邮箱创建后不可更改。官方建议专门开一个新邮箱用于发布，并且要是你会常查收的——下架、驳回等重要通知默认发邮件。
• 预算好一次性注册费，金额以开发者后台实付页为准。
• 扩展素材备齐：manifest.json、图标、截图、简介文案——5 个标签页的必填项不少，现做会打断流程。
• 确认范围：本教程只覆盖 Chrome 应用商店的 Manifest V3 扩展，Firefox、Edge 上架不在本路线内。

核心思路

chrome 插件上架的本质，是把「你电脑里的一个文件夹」变成「商店里的一个商品」。三步各管一件事：

阶段	你要做的事	产出	最容易错的地方
① 注册	交一次性注册费，拿到开发者账号	一个能发布商品的账号	邮箱创建后不可更改
② 打包	检查 manifest，压成合规 zip	manifest 在根目录的 zip 包	zip 里多套了一层文件夹
③ 提审	上传 zip，填 5 个标签页，提交	商品进入审核队列	必填项没填齐就点提交

三步是串行的：账号是入场券，zip 是商品本体，商品信息是货架陈列。审核员收到的是这三样的组合，任何一环出错都会被打回重来。

跟我做

第 1 步：注册开发者账号（chrome 插件上架第一步）

为什么：没有开发者账号，开发者后台连「新增商品」的入口都不会给你——先拿到这张入场券，后面两步才有地方落脚。

打开 Chrome Web Store 开发者后台（chrome.google.com/webstore/devconsole），用 Google 账号登录。首次进入会出现注册页：先同意开发者协议和政策，再支付一次性注册费。注册时需要提供开发者邮箱；中国（China）在支持注册的国家/地区名单内。

你应该看到：支付完成后再进后台，注册页不再出现，能看到商品列表和「新增商品（Add new item）」按钮。

• 注册页不再出现，后台能看到「新增商品」入口

第 2 步：检查 manifest 并打包成 zip（插件打包 zip）

为什么：扩展一旦上传，你就没法在开发者后台改 manifest 的元数据了——哪怕一个错别字，都得改文件、升版本号、重新打包。所以打包前先把 manifest 检查一遍。

按顺序检查四件事：

1. name、version、icons、description 四个字段齐全——name 会显示在商店和浏览器里，description 不能超过 132 个字符。
2. version 设低值，如 0.0.0.1——商店要求每个新上传的版本号都必须比上一个大，低值起步才留得出递增空间。
3. manifest 里不能留注释——注释是上传时报「Cannot parse the manifest」的常见原因。
4. 压缩时选中扩展目录里面的文件再压，manifest.json 必须落在 zip 的根目录，不能被套进子文件夹。包体上限 2GB，普通插件远碰不到。

你应该看到：把 zip 解压到一个临时目录，第一层就能直接看到 manifest.json。

• 解压 zip，第一层就是 manifest.json

第 3 步：上传 zip、填写商品信息并提交审核（插件提审）

为什么：zip 只是商品本体，商店还要求你把「货架信息」补齐——用户靠它们决定装不装，审核员靠它们判断你的插件是干什么的。

1. 在开发者后台点 Add new item，选 Choose file 选中刚打好的 zip，点 Upload。zip 和 manifest 有效的话，会进入商品编辑页。
2. 依次填完左侧菜单的 5 个标签页：
   • Package：上传包的信息，首次创建时这一页不可编辑；
   • Store Listing：商品详情，决定商店页面怎么展示；
   • Privacy：声明扩展的单一用途、以及它如何处理用户数据；
   • Distribution：是否付费、在哪些国家上架、对哪些用户可见；
   • Test instructions：给审核员的测试说明和凭据，仅在必要时填。
3. 必填项全部补齐后，点 Submit for Review，在确认弹窗里再确认一次。

你应该看到：商品状态变为「审核中」，后台商品列表里出现你的扩展。

• 5 个标签页必填项填完，状态已变为「审核中」

💡 想自己控制上线时间？

提交确认弹窗里可以控制发布时机：取消勾选那个选项，审核完成后商品不会立即自动上线，你可以择时手动发布。什么时候发、怎么回滚，下一课细讲。

⚠️ 新发布者有数量上限

刚创建发布者账号时，最多只能有 2 个已发布扩展（按在架数计，主题不占名额）。当前上限在开发者后台可见，达到上限可以申请提升，多数情况会立即给出结果。先把一个插件打磨好，比一次塞一堆上去强。

检查点 ✅

• 注册页不再出现，开发者后台能看到「新增商品（Add new item）」入口
• zip 解压后第一层就是 manifest.json，manifest 里没有注释
• manifest 四字段齐全，description ≤ 132 字符，version 从 0.0.0.1 这类低值起步
• 5 个标签页必填项全部填完，已点 Submit for Review
• 后台商品状态显示「审核中」，注册邮箱是你会常查收的邮箱

踩坑提醒

❌ zip 里多套了一层文件夹

压缩时把整个项目文件夹拖进去压，manifest.json 被压进了子目录。

原因：商店要求 manifest 必须在 zip 的根目录，多套一层直接失败。

正确做法：选中扩展目录里面的文件再压缩；提交前把 zip 解压一次，确认第一层就是 manifest.json。

❌ manifest 里留着注释

上传时报「Cannot parse the manifest」。

原因：manifest 是 JSON 文件，带注释是触发这个解析错误的常见原因。

正确做法：删掉 manifest 里的所有注释，重新打包上传。

❌ 随手填了一个不常看的邮箱

原因：开发者账号的邮箱创建后不可更改，要换只能新建账号、再通过官方表单把商品转移过去；下架、驳回等重要通知默认发到这个邮箱，漏看会耽误事。

正确做法：注册前想清楚。官方建议专门开一个新邮箱用于发布，并确保它是你会经常查收的。

❌ 版本号一上来就写很大

原因：商店要求每个新上传的版本号都必须比上一个大；而且上传后 manifest 元数据不能在后台改，改一个错别字都得升版本号、重新打包。起步写太大，后面没得涨。

正确做法：首个版本号设低值，如 0.0.0.1。

本课小结

chrome 插件上架就是三步：注册开发者账号 → 打包 zip → 提交审核。

• ✅ 注册：一次性注册费（金额以实付页为准），邮箱创建后不可更改
• ✅ 打包：manifest 四字段齐全、无注释，zip 根目录放 manifest.json，包体 ≤ 2GB
• ✅ 提审：Add new item 上传 zip，填完 5 个标签页，点 Submit for Review
• ✅ 新发布者最多 2 个已发布扩展，先集中打磨一个

关键配置字段回顾：

字段	推荐值	说明
manifest.json 的 version	0.0.0.1 这类低值	每个新版本号必须比上一个大，低值起步留递增空间
manifest.json 的 description	≤ 132 字符	商店详情展示用，上限 132 字符
manifest.json 的 name、icons	提前定稿	上传后 manifest 元数据不能在后台改
zip 结构	manifest.json 在根目录	多套一层文件夹会失败
包体大小	≤ 2GB	超过会被拒

下一课预告

提交只是开始：审核要多久、怎么提高过审率、被拒后如何整改？继续学《商店审核与发布策略：3 天审完、灰度与回滚》。

你会学到：

• 商店审核的流程和大致周期
• 提高过审率可以做哪些准备
• 被拒后的整改与重新提交
• 灰度发布与回滚怎么做

走微信小程序路线的话，可以对照《提交审核与发布：微信审核规则避坑指南》。