VSCode如何发布插件到Marketplace_VSCode插件发布到Marketplace教程

package.json 里哪些字段不填或填错会导致审核失败

登录只是拿到了入场券，真正的“考试”在package.json这个配置文件里。Marketplace的自动化校验系统会仔细检查其中的关键字段，任何缺失或格式错误都可能导致上传被拒绝，有时甚至只是静默失败，让你摸不着头脑。

• publisher字段：必须和你在vsce login时使用的ID完全一致，连大小写都不能错。
• name字段：命名有讲究，只能包含小写字母、数字和连字符。更重要的是，它不能和Marketplace上已有的任何插件重名（可以用vsce create命令预先检查一下）。
• version字段：必须使用标准的语义化版本格式，例如1.0.0。写成1.0或v1.0.0都是不行的。
• 图片资源路径：icon和galleryBanner指向的图片文件必须真实存在，并且尺寸要符合要求（图标128×128像素，横幅1280×560像素）。
• 引擎版本：engines.vscode字段建议设置为"^1.70.0"或更高。如果版本号太老（比如"^1.20.0"），插件可能会被标记为“不兼容”。

为什么 vsce publish 报错 Extension 'xxx' already exists

遇到这个错误，先别急着检查网络。它的意思很明确：你试图发布的这个插件，其名称和版本号组合，在Marketplace上已经存在了。平台不允许覆盖任何已发布的版本。

• 黄金法则：每次发布前先升版本号。只要代码有改动，想重新发布，就必须先更新package.json里的version字段，哪怕只是从1.0.0微调到1.0.1。
• 只想本地测试？ 可以使用vsce package命令生成一个.vsix文件，然后在VS Code里直接安装这个文件，完全绕开Marketplace。
• 误删了已发布的插件想重发？ 很遗憾，同名同版本的插件无法再次发布。要么给插件名加个后缀（比如-beta）当作新插件发布，要么等待72小时左右（系统可能有缓存延迟）再尝试。
• 开发的是内部私有插件？ 那就不要使用vsce publish命令公开到Marketplace。正确的做法是vsce package打包后，通过内部渠道分发.vsix文件。

这里有个容易被忽略的细节：publisher和name共同决定了插件的唯一身份。即使你修改了publisher字段，对于平台来说，这就是一个全新的发布者账号。而旧账号下所有已发布的历史版本，其归属权依然属于原来的发布者，无法直接迁移。如果确实需要更换发布主体，唯一的办法是给插件重新命名，并通知用户进行迁移。