vs code 插件开发环境只需全局安装 yo、generator-code 和 vsce 三个 cli 工具，依赖 node.js ≥18.x；yo code 创建项目时须选 typescript、小写短横线 id、初始化 git、不启用 webpack；调试失败多因 launch.json runtimeexecutable 路径错误、activationevents 不匹配或 tsconfig.json 与 package.json 的 outdir/main 不一致；vsce 打包失败常见于权限不足、publisher 非法或图标路径错误。
直接上手就能跑，不需要等“准备完成”——VS Code 插件开发环境的核心就是 yo、generator-code 和 vsce 这三个 CLI 工具，缺一不可，且必须全局安装。
装什么？只装这三个命令行工具
插件开发不依赖 VS Code GUI 操作，全程靠终端命令驱动。你不需要下载额外 IDE 或 SDK，只要 Node.js（≥18.x）已就位，执行以下两条命令即可：
-
npm install -g yo generator-code：装脚手架和 VS Code 专用模板生成器 -
npm install -g @vscode/vsce：装发布工具，后续打包.vsix、上传 Marketplace 全靠它
注意：yo 不是 VS Code 插件，它是通用脚手架；generator-code 才是真正生成 extension.ts 和 package.json 的关键。如果只装了 yo 没装 generator-code，运行 yo code 会报错 Error: No generator named 'code'。
yo code 交互时怎么选才不踩坑
运行 yo code 后的选项直接影响项目可维护性，几个关键点必须手动确认：
- “Type of extension”：选
New Extension (TypeScript)，不是 JavaScript —— TypeScript 提供类型提示、编译期检查，vscodeAPI 本身也以 TS 为主，JS 项目后期补类型定义极其痛苦 - “Identifier”：填小写短横线格式，如
my-hello-world，不能含下划线或大写字母，这是插件在 Marketplace 的唯一 ID，改不了 - “Initialize a git repository?”：选
Yes，哪怕你暂时不用 Git，因为vsce package默认要求有 Git 仓库（否则报错Not in a git repository） - “Bundle with webpack?”：选
No，新手绕开构建复杂度；等你加了第三方依赖（如axios）再考虑引入打包
生成完别急着写代码，先 cd 进目录，运行 npm install 确保依赖拉全，再用 code . 打开项目 —— 此时 VS Code 会自动识别为插件工程，底部状态栏显示 “Extension Development Host”。
调试时 Extension Development Host 启不来？查这三处
按 F5 启动插件调试却卡在白屏或报错，90% 是配置没对齐：
-
.vscode/launch.json中的runtimeExecutable必须指向你本地安装的 VS Code 可执行文件。Windows 默认是"C:\Users\xxx\AppData\Local\Programs\Microsoft VS Code\Code.exe"，不能写成code或留空 -
package.json的activationEvents要匹配你注册的命令。比如你在extension.ts里写了vscode.commands.registerCommand('helloWorld.sayHi', ...)，那activationEvents就得有"onCommand:helloWorld.sayHi"，少一个字母就激活失败 - TypeScript 编译输出路径要一致：
tsconfig.json的outDir（默认./out）必须和package.json的main字段值（默认"./out/extension.js"）严格对应，否则调试时加载的是旧 JS 文件
改完配置记得重启调试会话，不要只点 “重新启动” —— 它不会重载 launch.json 修改。
为什么 vsce package 总失败？权限和路径是隐形杀手
打包前 vsce package 报错，常见于 Windows 用户：
- 终端没以管理员身份运行：当项目路径含空格（如
C:My Projectsmy-ext）或在 OneDrive/桌面等受保护目录时，vsce读取package.json可能被系统拦截，直接换到D:projectsmy-ext这类干净路径重试 -
publisher字段为空或非法：打开package.json，确认"publisher": "your-name"已改成你在 Marketplace 注册的用户名（纯小写字母+数字+短横线），否则vsce会拒绝打包 - 图标文件路径错位：
contributes里如果配了icon，路径必须相对于package.json，且文件实际存在。建议初期删掉图标配置，避免因 404 导致打包中断
真正麻烦的不是搭建，而是每次改完 extension.ts 都得手动 F5 重启调试窗口 —— 它不像 Web 开发有热更新。习惯这点，你就跨过了第一个心理门槛。
