VSCode调试Electron主进程必须满足三个硬性条件：Node.js版本限定在v18.15.0–v20.14.0、Electron本地安装且≥38.1.2、launch.json中type为"node"且args严格为["--inspect=9229", "."]。
VSCode 调试 Electron 主进程不是“配个 launch.json 就能跑”，而是必须满足三个硬性条件：Node.js 版本卡在 v18.15.0–v20.14.0、Electron 本地安装且 ≥38.1.2、launch.json 中 type 必须为 "node" 且 args 顺序严格为 ["--inspect=9229", "."]。少一个，断点就灰掉。
主进程调试配置为什么总不生效？
常见现象是：断点打在 main.js 上，但运行后完全不中断，控制台也无调试日志。根本原因不是配置漏项，而是底层环境错配：
-
runtimeExecutable指向了全局electron命令（如npm install -g electron），导致 VSCode 启动的 Electron 版本和项目实际依赖的版本不一致；必须用"${workspaceFolder}/node_modules/.bin/electron"（Windows 加.cmd后缀） -
args写成[".", "--inspect=9229"]—— Electron 12+ 会直接忽略该参数，因为--inspect必须出现在.之前 - Node.js 版本超出 v18.15.0–v20.14.0 范围：v22+ 报
ERR_MODULE_NOT_FOUND，v16 及更早触发DEP0148并使 IPC 失效 - 没加
"env": { "ELECTRON_ENABLE_LOGGING": "true" }，导致窗口白屏或app未定义却无任何提示
launch.json 最简可靠写法（纯 JS 项目）
不要套模板，直接复制粘贴以下内容到 .vscode/launch.json 的 configurations 数组中：
{
"type": "node",
"request": "launch",
"name": "Debug Main Process",
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
"windows": {
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron.cmd"
},
"args": ["--inspect=9229", "."],
"console": "integratedTerminal",
"env": {
"ELECTRON_ENABLE_LOGGING": "true"
}
}
说明：
- 删掉
sourceMaps和outFiles—— 这两项只在 TypeScript 或打包后（如electron-builder）才需要；纯 JS 项目加了反而干扰路径匹配 -
console设为"integratedTerminal"，方便第一时间看到ELECTRON_ENABLE_LOGGING输出的 IPC、窗口创建等关键日志 - 如果项目用了
electron-vite或electron-forge，它们会封装启动逻辑，此时main.js入口可能被重定向，需检查实际入口文件路径是否仍是.
断点进了但 app 是 undefined？查模块系统冲突
在断点处打开调试控制台，执行 typeof app，返回 "undefined" 就基本坐实了问题。这不是代码写错了，而是加载机制打架：
- Electron 主进程默认用 CommonJS 加载
main.js，但如果你用了import语法（尤其配合 Vite 或 TypeScript），Node.js 可能以 ESM 模式加载，导致require('electron')返回空对象 - 临时验证：把
main.js第一行改成console.log(module.constructor.name)，运行看输出是Module（ESM）还是NativeModule（CommonJS） - 解决方案：要么统一用
require（推荐主进程保持 CommonJS），要么在package.json中显式声明"type": "commonjs"强制降级
真正卡住人的从来不是怎么写配置，而是 Node.js 版本、Electron 安装方式、模块加载模式这三者之间的隐式耦合——它们不出错时一切正常，一出错就全链路静默失败，连错误信息都不给你吐。
