VS Code 扩展如何发布到市场？

VS Code 扩展发布与市场管理

VS Code 扩展发布是将开发完成的扩展发布到 VS Code 市场供其他用户使用的过程。了解发布流程和市场管理对于扩展开发者至关重要。

发布前准备

扩展验证清单

1. 确保扩展功能完整且经过测试
2. 编写清晰的 README.md 文档
3. 准备扩展图标（128x128 像素）
4. 添加适当的标签和分类
5. 验证 package.json 配置

package.json 关键字段

json
{
  "name": "my-extension",
  "displayName": "My Extension",
  "description": "A useful VS Code extension",
  "version": "1.0.0",
  "publisher": "your-publisher-name",
  "engines": {
    "vscode": "^1.60.0"
  },
  "categories": [
    "Other",
    "Snippets"
  ],
  "keywords": [
    "utility",
    "productivity"
  ],
  "icon": "icon.png",
  "repository": {
    "type": "git",
    "url": "https://github.com/username/my-extension"
  },
  "license": "MIT"
}

发布者注册

创建发布者账户

1. 访问 https://dev.azure.com/
2. 使用 Microsoft 账户登录
3. 创建新的组织或使用现有组织
4. 在 VS Code 市场创建发布者
5. 获取发布者名称（用于 package.json 的 publisher 字段）

发布者信息

• 发布者名称：全局唯一，用于标识扩展发布者
• 显示名称：在市场中显示的名称
• 邮箱：用于接收通知

发布工具安装

安装 vsce（VS Code Extension Manager）

bash
npm install -g @vscode/vsce

验证安装

bash
vsce --version

打包扩展

基本打包命令

bash
vsce package

指定输出文件名

bash
vsce package --out my-extension-1.0.0.vsix

打包选项

• --baseContentUrl: 设置基础内容 URL
• --baseImagesUrl: 设置基础图片 URL
• --yarn: 使用 yarn 而非 npm

发布扩展

首次发布

bash
vsce publish

指定版本发布

bash
vsce publish minor
vsce publish patch
vsce publish 1.1.0

发布到预发布频道

bash
vsce publish --pre-release

发布到特定目标

bash
vsce publish --target win32-x64
vsce publish --target linux-x64,darwin-arm64

版本管理

语义化版本

• 主版本（Major）: 不兼容的 API 变更
• 次版本（Minor）: 向后兼容的功能新增
• 修订版本（Patch）: 向后兼容的问题修复

更新 package.json

json
{
  "version": "1.1.0"
}

扩展管理

更新扩展

1. 修改代码和 package.json 版本号
2. 重新打包：vsce package
3. 发布新版本：vsce publish

废弃扩展

bash
vsce unpublish my-extension

删除特定版本

bash
vsce delete my-extension 1.0.0

市场优化

SEO 优化

• 使用相关关键词
• 编写吸引人的描述
• 添加适当的标签
• 提供清晰的截图和演示

用户评价管理

• 积极回应用户反馈
• 及时修复报告的问题
• 根据用户建议改进功能

统计分析

• 访问 VS Code 市场统计页面
• 查看下载量和安装量
• 分析用户行为和反馈

注意事项

• 确保扩展遵守 VS Code 市场政策
• 不要发布恶意或有害的扩展
• 定期更新扩展以保持兼容性
• 保护好发布者账户的访问令牌
• 考虑开源代码以增加信任度