用途:系统化掌握 VSCode 扩展开发技能,涵盖扩展基础、API 使用、TreeView、Webview 与扩展发布,适合需要完整学习该流程或查询特定模块参考的用户。
前置准备:需 Node.js 18+、Git、VSCode 最新版,并安装 npm install -g yo generator-code @vscode/vsce。
技能模块:基础部分含 vscode-extension-basics(项目搭建、package.json 配置、激活事件、调试运行)与 vscode-extension-api(commands、window、workspace、debug API);功能部分含 vscode-extension-treeview(TreeDataProvider、View Container)与 vscode-extension-webview(Webview Panel、消息传递、状态管理、CSP);发布部分含 vscode-extension-publishing(vsce 工具、发布流程、平台特定扩展)。
学习路径与时长建议:basics 1-2 天,api 2-3 天,treeview/webview 各 2-3 天,publishing 1 天。资源索引提供各模块参考文档(如 activation-events.md、commands-api.md、webview-security.md、vsce-cli.md 等)。
常见用法:创建第一个扩展用 basics(npx yo code 后调试运行);实现命令面板用 api(registerCommand 配合 contributes);显示文件树用 treeview;嵌入网页界面用 webview(createWebviewPanel);发布用 publishing(vsce publish)。
注意事项:版本兼容用 engines.vscode 指定最低兼容版本,推荐 ^1.74.0 及以上;资源管理上所有 Disposable 需加入 context.subscriptions,Webview 面板需处理 onDidDispose;安全上 Webview 必须配置 CSP、用 localResourceRoots 限制资源访问并验证清理用户输入;发布时扩展名称需全局唯一,遵循 SemVer,预发布版本使用奇数 patch。收费、价格与其它平台支持情况暂未提供。