要为 VSCode 开发自定义扩展插件，需先安装 Node.js 和 Yeoman（npm install -g yo generator-code），再运行 yo code 创建 TypeScript 项目，编辑 src/extension.ts 实现 activate 函数，通过 F5 调试，最后用 vsce package 打包为 .vsix 安装。
如果您希望为 Visual Studio Code 开发一个自定义扩展插件，但尚未创建过任何插件项目，则可能是由于缺乏初始化环境与基础项目结构。以下是完成该任务的步骤：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装必要工具与依赖
开发 VSCode 扩展需要 Node.js 运行时和 Yeoman 脚手架工具，它们共同构成插件项目的生成基础。VSCode 官方推荐使用 @vscode/vsce 工具进行打包与发布，因此需提前配置。
1、访问 https://nodejs.org 下载并安装最新 LTS 版本的 Node.js。
2、在终端中执行 npm install -g yo generator-code 安装 Yeoman 与 VSCode 官方代码生成器。
3、验证安装是否成功：运行 yo code --version，应输出版本号（如 1.10.0）。
二、生成初始扩展项目
Yeoman 提供交互式向导，可自动创建符合 VSCode 扩展规范的文件结构，包括 package.json、extension.ts 和激活逻辑入口。
1、在终端中执行 yo code 启动向导。
2、依次选择 New Extension (TypeScript) 作为模板类型。
3、输入扩展名称（如 my-first-extension）、标识符（默认基于名称生成）、描述、作者姓名及许可证类型。
4、确认生成路径后，脚手架将自动创建完整项目目录，并运行 npm install 安装依赖。
三、编写核心功能逻辑
扩展的核心行为由 extension.ts 中的 activate 函数定义，该函数在插件被首次调用时触发，用于注册命令、事件监听器或 UI 元素。
1、打开项目根目录下的 src/extension.ts 文件。
使用 Vite 8、React 19、Tailwind CSS v4、shadcn/ui、Biome、Vitest 和 Hono 构建全栈 TypeScript 应用，涵盖前端（Vite/Rolldown 构建 + 开发）...
2、在 activate 函数内部添加如下代码：vscode.window.showInformationMessage('Hello from my-first-extension!');
3、在 deactivate 函数中保留空实现或添加清理逻辑（如取消订阅事件）。
四、调试扩展插件
VSCode 提供内置的 Extension Development Host 环境，允许在隔离窗口中实时加载并测试未发布的扩展，避免影响主编辑器稳定性。
1、在 VSCode 中打开刚生成的项目文件夹。
2、按 Cmd+Shift+P（macOS）调出命令面板，输入并选择 Tasks: Run Build Task，确保 TypeScript 编译通过。
3、按 F5 启动调试，默认会启动一个新窗口并加载当前扩展。
4、在新窗口中按 Cmd+Shift+P，输入 Hello World 并执行对应命令，观察右下角是否弹出提示消息。
五、打包与本地安装
打包操作将源码编译为 .vsix 文件，该格式可被 VSCode 直接识别并安装，适用于分发或跨设备部署。
1、在终端中进入项目根目录，运行 npx vsce package。
2、确认输出目录中生成了 my-first-extension-0.0.1.vsix 文件。
3、在 VSCode 主界面中点击左侧活动栏的扩展图标，点击右上角三个点，选择 Install from VSIX...。
4、定位并选择刚生成的 .vsix 文件，点击 Install 完成本地安装。
