VSCode扩展打包_发布到市场的完整流程

确保扩展项目包含 package.json、README.md 等必要文件，其中 publisher 字段需与 VSCode Marketplace 创建的发布者 ID 一致。2. 全局安装 vsce 工具：npm install -g @vscode/vsce。3. 登录 VS Code Marketplace 并创建发布者。4. 在 Azure DevOps 中生成具有 Marketplace 管理权限的 Personal Access Token。5. 使用 vsce login <publisher-id> 命令登录并输入 Token 完成身份验证。6. 运行 vsce package 生成 .vsix 扩展包用于测试。7. 执行 vsce publish 发布扩展，支持指定版本或使用 patch 等语义化增量发布。8. 发布后访问 marketplace.visualstudio.com/items?itemName=<publisher>.<name> 查看页面效果。9. 更新时修改 version 字段并重新发布，同步更新 CHANGELOG.md 和 README.md。整个流程依赖正确的项目配置和认证设置，后续维护简单高效。

把 VSCode 扩展打包并发布到 Visual Studio Code Marketplace 是一个清晰但需要细心操作的过程。下面是从开发完成到成功发布的完整流程，适用于第一次发布扩展的新手，也适合回顾发布细节的开发者。

1. 准备扩展项目结构

确保你的扩展项目包含以下关键文件：

• package.json：必须包含 name、version、publisher、main（入口文件）、contributes 等字段。
• vsc-extension-quickstart.md：初始化时生成的帮助文档，可删除。
• README.md：展示在市场页面的说明文档。
• CHANGELOG.md：更新日志，推荐添加。
• icons/ 和 gallery/：可选，用于市场展示图标和截图。

特别注意：publisher 字段是你在 VSCode Marketplace 上注册的发布者名称，必须提前创建。

2. 安装 vsce 工具

vsce（VS Code Extension Manager）是官方命令行工具，用于打包和发布扩展。

npm install -g @vscode/vsce

确保你已安装 Node.js（建议 v16+）和 npm。

3. 创建发布者（Publisher）

访问 VS Code Marketplace 并使用 Microsoft 账号登录。

1. 点击右上角头像 → “Manage Publishers”
2. 点击 “Create a publisher”
3. 填写发布者 ID（唯一标识，如 mycompany 或 yourname）
4. 记下这个 ID，它将用于 package.json 中的 publisher 字段

4. 登录 Azure DevOps（用于身份验证）

发布扩展需通过 Azure DevOps 认证。

1. 访问：https://www.php.cn/link/a20cab171bfed09f88940ead90462022
2. 使用与 Marketplace 相同的 Microsoft 账号登录
3. 进入个人设置（右上角头像 → Personal Access Tokens）
4. 点击“New Token”，设置：
   • Name: vsce-publish
   • Organization: All accessible organizations
   • Scopes: Select Marketplace (Manage)
5. 生成 Token，复制并保存（只显示一次）

5. 登录 vsce（使用 Personal Access Token）

在终端运行：

vsce login <your-publisher-id>

例如：

vsce login john-doe

然后输入你刚刚创建的 Personal Access Token。

成功后，vsce 会缓存凭证，后续发布无需重复登录。

6. 打包扩展（.vsix 文件）

在项目根目录运行：

vsce package

生成一个 your-extension-name-version.vsix 文件，可用于本地安装或测试。

有道智云AI开放平台

有道智云AI开放平台

116

查看详情

如果想跳过某些文件，可在 .vscodeignore 中配置，类似 .gitignore。

7. 发布扩展到 Marketplace

直接发布当前版本：

vsce publish

这条命令会自动打包并上传到 Marketplace。

也可以指定版本号发布：

vsce publish 1.0.1

支持语义化版本（semver），如 patch、minor、major：

vsce publish patch

这会自动递增版本号并发布。

8. 验证发布结果

发布完成后，访问：

https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1/items?itemName=<publisher>.<name>

例如：

https://www.php.cn/link/76cb2624c9d093d029a3a43ae55148f1/items?itemName=john-doe.my-awesome-extension

稍等几分钟，新版本通常很快可见。

9. 后续维护与更新

每次更新代码后，只需修改 package.json 中的 version 字段，然后再次运行：

vsce publish

确保更新 CHANGELOG.md 和 README.md，让用户清楚变化。

基本上就这些。整个流程不复杂，但容易忽略发布者创建和 Token 权限配置。只要准备好 vsce 环境和认证信息，发布就像提交一次 npm 包一样简单。

以上就是VSCode扩展打包_发布到市场的完整流程的详细内容，更多请关注php中文网其它相关文章！