默认 yo code 模板不能直接用于生产，因其仅为“能跑通”的最小集，缺乏构建优化、类型校验闭环与调试链路加固；需调整 engines.vscode 兼容性、tsconfig.json 的 module/target/types 配置、launch.json 的 runtimeExecutable 与 reloadeAfterChange，以及确保 vsce 打包内容纯净且环境一致。
直接用 yo code 生成的默认模板不能直接进生产，缺构建优化、类型校验闭环、调试链路加固——尤其当你需要支持多 VS Code 版本、打包后不报 Cannot find module 'vscode'、或者想让同事拉代码就能 npm run watch 实时看到修改效果时。
为什么默认 yo code 模板在真实项目里会卡住？
它生成的是“能跑通”的最小集，不是“能维护”的工程化起点。常见断点包括：
-
package.json中engines.vscode写死"^1.80.0"，但你团队还在用 1.78 —— 插件根本不会激活 -
tsconfig.json缺少"skipLibCheck": true，一升级@types/vscode就编译失败 - 没配
outDir和rootDir映射，import路径和实际输出结构对不上，调试时断点打不进源码 -
.vscode/launch.json用默认type: "pwa-extensionhost"，但没加"runtimeExecutable"指向本地 VS Code 可执行文件，导致 F5 启动失败或加载旧版本插件
tsconfig.json 必须改的三项配置
不是照抄示例，而是匹配 VS Code 扩展运行时的真实约束：
-
"module": "commonjs"—— VS Code 不支持 ESM 动态导入，设成es2020或nodenext会导致require()失败 -
"target": "ES2020"—— 低于这个目标（如 ES2015）会产出class语法，而某些旧版 VS Code 的 Electron 内核无法解析 -
"types": ["node", "vscode"]—— 必须显式声明，否则tsc -b构建时可能漏掉@types/vscode类型定义，导致vscode.ExtensionContext报错
如何让 npm run watch 真正热更新？
默认模板只有 npm run compile，每次改完要手动 F5 刷新开发主机。要实现保存即生效，得串起三件事：
- 用
tsc -w监听src/**/*.ts，输出到out/ - 在
.vscode/launch.json里加"reloadeAfterChange": true（VS Code 1.85+ 支持），否则扩展进程不会自动重启 - 把
out/extension.js的路径写进package.json的"main"字段，且确保它和tsc输出路径严格一致；路径错一个字符，调试器就加载空模块
打包前必须验证的两个检查点
vsce package 成功 ≠ 插件能装上。最容易被忽略的其实是环境一致性：
- 检查
node_modules/@types/vscode是否存在且版本与engines.vscode兼容（例如 VS Code 1.87 对应@types/vscode@1.87.0）；漏装或版本错位，安装后直接报Extension host terminated unexpectedly - 运行
vsce ls查看打包内容：确认out/下有extension.js和extension.js.map，且没有意外打包进src/或node_modules/（后者会让 .vsix 体积暴涨且触发安全拦截）
真正的工程化不是堆工具链，而是让每个环节的失败都有明确错误指向——比如改了 activationEvents 却没清缓存，VS Code 就静默跳过你的插件；又比如 vscode.window.showQuickPick() 在非 UI 线程调用，只报 “rejected promise” 却不告诉你哪行代码触发的。这些细节不写死在配置里，迟早要花半天翻日志。
