需完成初始化项目、编写功能代码、本地调试、打包为.vsix文件及发布至Marketplace五步:先用yo code生成TypeScript项目;在extension.ts中注册命令并实现逻辑;通过Extension Development Host调试;用vsce package打包;最后用vsce publish发布。

如果您希望为 Visual Studio Code 开发并公开一个自定义扩展,则需要完成初始化项目、编写功能代码、打包以及发布到 Visual Studio Code Marketplace 等多个环节。以下是实现该目标的具体操作流程:
本文运行环境:MacBook Pro,macOS Sequoia。
一、安装必要工具与初始化项目
创建 VS Code 扩展依赖 Node.js 环境和 Yeoman 脚手架工具,用于快速生成标准项目结构。需确保已安装最新稳定版 Node.js,并通过 npm 全局安装相关开发依赖。
1、在终端中执行 npm install -g yo generator-code 安装 Yeoman 与 VS Code 扩展生成器。
2、运行 yo code 启动向导,选择“New Extension (TypeScript)”类型。
3、按提示输入扩展名称、标识符(id)、描述、作者等元信息,生成完整 TypeScript 项目目录。
二、编写核心功能逻辑
扩展的核心行为由 extension.ts 文件中的 activate 函数定义,它在扩展被启用时执行。所有命令注册、事件监听和 UI 注入均在此处完成,是功能实现的主入口点。
1、打开 src/extension.ts,定位到 activate 函数内部。
2、调用 vscode.commands.registerCommand 注册一个新命令,例如 'extension.helloWorld'。
3、在对应命令回调中使用 vscode.window.showInformationMessage 弹出测试提示,验证基础功能可运行。
三、本地调试与测试
VS Code 提供内置的 Extension Development Host 环境,允许在隔离窗口中加载未发布的扩展,便于实时验证行为是否符合预期,避免影响主编辑器工作流。
1、按下 Cmd+Shift+P(macOS)打开命令面板,输入并选择 “Developer: Toggle Developer Tools” 查看控制台输出。
2、点击侧边栏的“运行和调试”图标,选择配置为 “Extension Development Host”,然后点击绿色三角形启动调试会话。
3、在新开的窗口中按下 Cmd+Shift+P,输入刚注册的命令名并执行,确认弹窗正常出现。
四、打包为 .vsix 发布文件
VS Code Marketplace 接收的是经过签名和压缩的 .vsix 格式文件,该文件由 vsce 工具生成,包含扩展源码、package.json 清单及资源文件。
1、在项目根目录执行 npm install -g vsce 安装发布工具。
2、运行 vsce package 命令,生成当前版本的 .vsix 文件(如 my-extension-0.0.1.vsix)。
3、检查生成文件是否包含有效的 package.json、icon 图标、README.md 及 license 文件,缺失将导致 Marketplace 审核失败。
五、发布至 Visual Studio Code Marketplace
发布前需注册 Microsoft Partner Center 账户并创建个人访问令牌(PAT),该令牌用于 vsce 登录并提交扩展包,是唯一身份凭证。
1、访问 https://partner.microsoft.com/en-us/dashboard/commercial-marketplace/overview 注册并完成开发者资料认证。
2、在“Certificates & secrets”页面创建一个新的 PAT,勾选 “Marketplace::Publish” 权限,复制生成的令牌值。
3、在终端执行 vsce login YourPublisherName,粘贴令牌完成登录,随后运行 vsce publish 提交扩展。










