用途:本技能用于掌握 VSCode 扩展开发的基础知识与入门实践,覆盖项目搭建、package.json 配置、激活事件、贡献点和调试运行。当需要创建 VSCode 扩展或学习扩展开发基础时适用。
环境与安装:需 Node.js 18+、Git、最新版 VSCode。工具安装命令为 npm install -g yo generator-code。
使用方式:用 npx yo code 通过 Yeoman 脚手架创建项目,按提示选择 Extension Type: New Extension (TypeScript),填写名称、标识、描述,初始化 git 仓库,Bundler 选 unbundled,包管理器选 npm。项目结构包含 .vscode/launch.json、.vscode/tasks.json、src/extension.ts、package.json、tsconfig.json、README.md。package.json 关键字段包括 name、displayName、version、publisher、engines.vscode、main、activationEvents 与 contributes.commands。扩展入口导出 activate 与 deactivate,用 vscode.commands.registerCommand 注册命令,并通过 context.subscriptions.push() 管理可释放资源。调试时按 F5 或执行 Debug: Start Debugging,在扩展开发主机窗口的命令面板中运行命令。
主要能力:搭建扩展项目、配置扩展清单、声明贡献点、注册命令、调试运行。添加新命令时,在 contributes.commands 中定义命令,再用 registerCommand 注册处理函数。
限制与注意事项:engines.vscode 指定最低兼容版本,^1.74.0 表示兼容 1.74.0 及以上;VSCode 1.74+ 会为 commands 贡献自动生成激活事件。扩展 ID 格式为 <publisher>.<name>,publisher 来自 Marketplace 发布者账户,ID 创建后不可更改。推荐使用 TypeScript,编译输出到 out/ 目录,发布前使用 vscode:prepublish 脚本编译。基础技能以文档和实践为主,无必要脚本;深入内容可参考 references/extension-anatomy.md、references/activation-events.md、references/contribution-points.md。其他收费、价格、平台效果等信息暂未提供。