yo code报错因yo和generator-code未全局安装或Node.js版本低于16.14；热更新失效因main路径错误、webpack配置缺失watchOptions；调试失败多因activate函数签名错误或launch.json路径不对；vsix安装失败常因engines.vscode版本范围过严或文件被系统拦截。
用 yo code 初始化项目时为什么报错“command not found”
因为 yo 和 generator-code 没装全局，或者 Node.js 版本太低（yo code 要求 Node.js ≥ 16.14）。
实操建议：
- 先确认 Node.js 版本：
node -v，若低于v16.14.0，用nvm切换或重装 - 全局安装依赖：
npm install -g yo generator-code（不用--legacy-peer-deps，新版已兼容） - 如果仍报
yo: command not found，检查 npm 全局 bin 路径是否在$PATH中（Linux/macOS 运行npm config get prefix，看输出路径下的bin是否已加入环境变量）
运行 npm run watch 后插件没热更新，改了代码也不生效
VS Code 插件开发默认启用 Extension Development Host 窗口，但热更新依赖 webpack 配置和 package.json 的 main 字段指向是否正确。
实操建议：
- 确保
package.json中"main"指向编译后入口（如"./out/extension.js"），不是源码路径 - 检查
webpack.config.js是否配置了devtool: 'source-map'和watchOptions（尤其 macOS 上需加ignored: /node_modules/防止 chokidar 崩溃） - 启动调试时必须用
F5或点击「Run Extension」按钮——直接code .打开项目不会触发调试环境
调试时报错 Cannot connect to runtime process
这是 VS Code 调试器找不到插件 host 进程的典型表现，多发生在 Windows 上杀毒软件拦截、WSL 环境路径解析异常，或插件未正确注册激活事件。
实操建议：
- 关闭 Windows Defender 实时保护临时测试（尤其
Code - Insiders或自定义code路径时易被误杀） - 检查
src/extension.ts中是否导出了activate函数，且函数签名是(context: ExtensionContext)—— 少一个参数或类型不对都会导致 host 启动失败 - 在
.vscode/launch.json中确认request是"launch"，且runtimeExecutable指向你本地安装的 VS Code 可执行文件（例如 Windows 上是"${env:USERPROFILE}\AppData\Local\Programs\Microsoft VS Code\Code.exe"）
打包 vsix 后安装提示 “This extension is not installable on any currently installed products”
根本原因是 package.json 里的 engines.vscode 版本范围与当前 VS Code 不匹配，比如写成了 "^1.80.0"，而你用的是 1.98.0，但 VS Code 严格校验语义化版本兼容性（^1.80.0 只接受 1.x.x，不接受 1.98.0？错——其实是接受的；真正常见问题是写了 "1.80.0" 固定版本，或用了 ~ 导致只允许补丁升级）。
实操建议：
- 把
engines.vscode改成宽松范围："^1.70.0"（覆盖绝大多数稳定版） - 打包前删掉
node_modules和out，再跑npm install && npm run package，避免残留旧构建产物 - 安装 vsix 时若提示不兼容，右键 vsix → “Properties” → “Unblock”（Windows），否则系统策略会静默拒绝加载
插件开发里最容易被忽略的，是 activationEvents 的声明方式——写成 "*" 虽然简单，但会让插件在每次启动 VS Code 时都加载，拖慢启动速度；而漏写 "onCommand:xxx 或 "onLanguage:json"，又会导致命令注册失败却无报错。这个边界得靠反复调试日志和 Developer: Toggle Developer Tools 里的 Extension Host 输出来确认。
