SuperAPI AI 工具集

vscode-extension-guide-en

编程与开发

查看项目

更新于 10-16 04:04

技能介绍

用途 本技能是一份英文版 VS Code 扩展开发指南,覆盖从脚手架搭建到发布到 VS Code Marketplace 的完整生命周期。它适用于以下场景:从零创建新的 VS Code 扩展;为扩展添加命令、快捷键或设置;在扩展中构建 TreeView 或 Webview 界面;将扩展发布到 VS Code Marketplace;排查扩展激活或打包问题。

主要能力 指南包含以下参考主题:带 CSP 安全和消息传递的 Webview 模式;TreeView 数据提供程序与拖放;使用 @vscode/test-electron 的测试设置;发布到 VS Code Marketplace;扩展项目的 AI 定制;扩展代码的代码审查提示;常见扩展问题的故障排查。内容已针对 VS Code 1.74+ API 更新,改编自 aktsmm/agent-skills(CC BY-NC-SA 4.0),翻译为英文并针对当前 VS Code API 进行了修正。

使用方式 快速开始:

npm install -g yo generator-code yo code

项目结构:

my-extension/ ├── package.json # Extension manifest ├── src/extension.ts # Entry point ├── out/ # Compiled JS ├── images/icon.png # 128x128 PNG for Marketplace └── .vscodeignore # Exclude files from VSIX

构建与打包:

npm run compile # Build once npm run watch # Watch mode (F5 to launch debug) npx @vscode/vsce package # Creates .vsix

安装完整技能(含所有参考文档):

npx skills add lewiswigmore/agent-skills --skill vscode-extension-guide-en

最佳实践 发布前统一包名、设置键、命令 ID 和视图 ID;使用 .vscodeignore 将包体积控制在 5MB 以下;自 VS Code 1.74 起,已贡献的命令和视图的 activationEvents 会被自动检测;打包前始终使用 Extension Development Host(F5)进行测试。

常见陷阱 扩展未加载:检查 activationEvents,自 VS Code 1.74 起已贡献的命令/视图会被自动检测。命令未找到:确保 package.json 与代码中的命令 ID 完全一致。Webview 内容不显示:检查内容安全策略,使用 webview 的 cspSource 属性。

相关技能 @test-driven-development:在实现扩展功能前编写测试;@debugging-strategies:针对扩展问题的系统性故障排查。

限制 仅在任务明确匹配上述范围时使用本技能。不要将输出视为环境特定验证、测试或专家审查的替代品。如果缺少必需的输入、权限、安全边界或成功标准,请停止并请求澄清。