vscode插件开发必须依赖yo+generator-code脚手架生成项目结构，而非vscode内置功能；需确保package.json、extension.js/ts、tsconfig.json和launch.json四文件正确配置，且工作目录、node版本、vscode版本、图标路径等均合规。
VSCode插件本身不生成代码库文件（如 package.json、tsconfig.json、src/extension.ts 等），而是靠脚手架工具自动生成——真正干活的是 yo + generator-code，不是 VSCode 或插件本身。
为什么直接在 VSCode 里点“新建插件”没反应
VSCode 编辑器不内置插件项目生成能力。所谓“创建插件”，本质是调用本地 Node.js 脚手架，在终端里执行命令生成文件结构。如果你跳过这步，只打开 VSCode 点来点去，package.json 和 extension.js 永远不会凭空出现。
- 常见错误现象：
F5启动调试时弹出“Cannot find module './extension.js'”或“Extension host terminated unexpectedly” - 根本原因：项目目录下压根没有
extension.js，也没有package.json中声明的入口字段 - 正确路径：必须先在终端运行
yo code，按提示选语言（JS/TS）、填名字、选包管理器（npm/yarn/pnpm） - 注意 Node 版本：2026 年多数新脚手架要求
node >= 18.17.0；用node -v确认，低于此版本大概率卡在依赖安装或生成失败
yo code 生成后，哪些文件是真正影响代码库构建的
生成结果里只有少数几个文件决定你后续能不能写、编译、调试、打包。其余都是文档或配置辅助项，可删可改，但以下 4 个不能缺、不能错名：
-
package.json：必须含"main": "./extension.js"（JS）或"main": "./out/extension.js"（TS+webpack），且"activationEvents"至少有一项，比如"onCommand:myext.hello"或兜底的"*" -
extension.js或src/extension.ts：入口逻辑所在，activate()函数必须导出，且不能有语法错误（TS 需先tsc编译） -
tsconfig.json（TS 项目）：关键字段"outDir": "./out"必须与package.json中"main"路径匹配，否则调试时加载的是未编译源码，报错 -
.vscode/launch.json：调试配置里"runtimeExecutable"应指向当前机器上真实 VSCode 可执行路径（Windows 默认是"${env:USERPROFILE}\AppData\Local\Programs\Microsoft VS Code\Code.exe"），路径错则调试窗口打不开
npm run watch / pnpm watch 不生效的典型原因
很多教程说“改完代码自动重编译”，但实际常卡住——不是命令错了，而是监听目标和输出路径没对齐。
- TS 项目若用
tsc --watch，必须确保tsconfig.json含"composite": true且"outDir"已设；否则修改后out/下无更新，调试仍加载旧 JS - JS 项目若没配构建步骤，
npm run watch默认只是空脚本，需手动在package.json中补："watch": "nodemon --watch extension.js --exec echo 'ready'"（仅用于热提示）或改用concurrently - 常见坑：
pnpm watch在某些 pnpm 版本（≤9.0）中会忽略src/**变更，降级到pnpm@8.15.5或改用npm run dev更稳 - 验证是否真监听成功：改一行
extension.js，看终端是否打印 “compiled successfully”，没输出=监听失效
打包 .vsix 前必须检查的三个硬性条件
vsce package 表面是打包命令，实则是校验流程。失败往往不是语法问题，而是元信息不合规：
-
package.json中"engines.vscode"值（如"^1.85.0"）不能高于你本地 VSCode 版本（用code --version查），高了就报 “Unsupported engine” 错误 - 插件图标缺失：必须在根目录放
icon.png（128×128 px），且package.json中"icon"字段值要精确匹配（如"icon": "icon.png"），大小写/路径错一个字符就打包失败 - 未签名的私有插件若含
"scripts.prepublish"（如"tsc -b"），而本地没装tsc全局命令，vsce会静默失败，建议改用"prepare"脚本并确保node_modules/.bin/tsc可达
最易被忽略的一点：所有生成操作（yo code、tsc、vsce package）都依赖当前 shell 的 PWD（工作目录）。切错目录、用 VSCode 内置终端却没 cd 进项目根，生成的文件就会散落在奇怪位置，后续调试全崩。
