用途:帮助掌握VSCode扩展开发的基础知识与入门实践,覆盖项目搭建、package.json配置、激活事件、贡献点、调试运行等环节,适用于需要创建VSCode扩展或学习扩展开发基础时。
前置准备:环境要求Node.js 18+、Git、最新版VSCode;工具安装命令为npm install -g yo generator-code。
使用方式:先用npx yo code通过Yeoman脚手架创建扩展,按提示选择New Extension (TypeScript)、填写名称与标识、初始化git仓库、选择unbundled与npm。随后理解项目结构(.vscode调试与任务配置、src/extension.ts入口、package.json清单、tsconfig.json等)。在package.json中配置name、displayName、version、publisher、engines.vscode、main、activationEvents与contributes.commands。入口文件导出activate与deactivate,用vscode.commands.registerCommand注册命令并通过context.subscriptions.push管理资源。按F5或运行Debug: Start Debugging在扩展开发主机窗口测试,用命令面板执行扩展命令。
限制与注意:engines.vscode用^1.74.0表示兼容1.74.0及以上;VSCode 1.74+会为commands贡献自动生成激活事件;扩展ID格式为<publisher>.<name>,一经创建不可更改;推荐使用TypeScript,编译输出到out/目录,发布前使用vscode:prepublish脚本编译。更多细节可参考references/extension-anatomy.md、activation-events.md、contribution-points.md。