Electron主进程调试需用VSCode的node类型配置而非electron类型，Electron 12+须显式加--inspect=9229参数，runtimeExecutable指向本地electron二进制，args中--inspect=9229必须在.前，避免attach模式。
主进程调试不生效？先确认 Electron 版本和 VSCode 配置匹配
electron 主进程本质是 node.js 进程，但默认启动方式（如 electron .）会绕过 vscode 的调试协议。vscode 无法自动 attach 到由 electron cli 启动的主进程，除非显式启用调试支持。
关键点在于：Electron 12+ 默认禁用 --inspect 参数，且 VSCode 的 launch.json 必须使用 node 类型而非 electron 类型来调试主进程（后者仅适用于渲染进程或旧版 Electron）。
- 检查 Electron 版本：
npx electron --version；若 ≥12，需在启动时手动加--inspect=9229 -
launch.json中type必须为"node"，不能是"pwa-node"或"electron"（后者已弃用且不支持主进程断点） - 确保
main.js入口文件路径正确，且未被electron-forge或electron-vite等工具封装隐藏
launch.json 怎么写才真正能断点进 main.js？
最简可靠配置是让 VSCode 直接运行 node 并传入 Electron 的 app 模块路径，同时注入调试参数。这种方式绕过 CLI，完全受 VSCode 控制。
{
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug Main Process",
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
"args": ["--inspect=9229", "."],
"console": "integratedTerminal",
"sourceMaps": true,
"outFiles": ["${workspaceFolder}/dist/main.js"],
"env": { "ELECTRON_ENABLE_LOGGING": "true" }
}
]
}
-
runtimeExecutable指向本地安装的electron二进制（不是全局），避免版本错配 -
args中--inspect=9229必须在.前，否则 Electron 忽略该参数 -
outFiles仅在使用 TypeScript 或打包后需要；纯 JS 项目可删掉 - 如果用了
electron-builder，调试前先执行npm run build，再把args改为["--inspect=9229", "dist/"]
断点命中但变量显示 undefined？检查 require 和 ES Module 混用问题
Electron 主进程默认用 CommonJS，但如果你在 main.js 中用了 import 语法（尤其配合 TypeScript 或 Vite），Node.js 可能以 ESM 模式加载，导致 VSCode 调试器无法正确解析作用域。
- 检查
package.json是否有"type": "module"—— 若有，必须统一用import，且launch.json中要加"runtimeArgs": ["--enable-source-maps"] - 常见现象：断点停在
createWindow()函数里，但app变量显示undefined；实际是 ESM 下require("electron")返回空对象 - 临时验证方式：在断点处执行调试控制台命令
typeof app，若返回"undefined"，基本确定是模块系统冲突 - 推荐解法：主进程保持 CommonJS（
const { app, BrowserWindow } = require("electron")），渲染进程再用 ESM
为什么 attach 模式总失败？别碰 attach 配置
试图用 attach 类型配置去连接已运行的 Electron 主进程，成功率极低。因为 Electron 启动后会快速执行初始化，等你手动运行 attach 时，关键代码早已执行完毕。
-
attach配置要求进程已带--inspect启动，但 Electron CLI 不透传该参数给主进程（只传给渲染进程） - 即使手敲命令
electron --inspect=9229 .，VSCode attach 也常因端口未就绪而超时 - 唯一稳定 attach 场景：用
node --inspect-brk=9229 node_modules/electron/cli.js .启动，再在 VSCode 中 attach；但--inspect-brk会卡在第一行，体验差 - 结论：坚持用
launch类型 + 正确runtimeExecutable，放弃attach
主进程调试真正的难点不在配置，而在 Electron 启动生命周期短、模块加载模式易混淆、以及不同构建工具对入口路径的封装。一旦 launch.json 能稳定停在 app.whenReady() 之前，后续就只是常规 Node.js 调试了。
