用途:指导从零创建、开发和发布 VS Code 扩展/插件,适用于新建扩展、添加命令/快捷键/设置、发布到 VS Code Marketplace 等场景。
主要能力:提供脚手架与手动初始化方式、推荐项目结构、构建与打包命令、完成标准(Done Criteria)以及常见故障排查表;并给出 Extension Host 边界、Manifest/文档/本地化、语言模型工具(LM Tools)、生成区块(generated section)与命名一致性等实践建议。
必要用法:脚手架推荐执行 npm install -g yo generator-code 后运行 yo code;手动方式为 mkdir my-extension && cd my-extension、npm init -y && npm install -D typescript @types/vscode。构建用 npm run compile 或 npm run watch(F5 启动调试);打包用 mkdir -p artifacts/vsix 与 npx @vscode/vsce package --out artifacts/vsix/my-extension-1.0.0.vsix。建议将本地 VSIX 放在 artifacts/vsix/ 而非仓库根目录并定期清理。
适用场景:扩展开发全流程,包括命令、键位、设置、TreeView、Webview、测试与发布;对带管理界面的扩展默认使用独立 Activity Bar 图标与侧边栏,并提供明确的反馈入口。
限制与注意:资料未提供具体收费、价格、平台支持范围或效果数据。发布前应检查打包后的 VSIX 而非仅信任源码;LM Tools 的 prepareInvocation 应无副作用,变更操作需确认,不得通过工具参数接收密钥或静默扩大权限;日志应集中到 Output Channel,避免在 Extension Host 同步执行大输入解析。