vscode 的 "electron" 调试类型已弃用，因自electron 12+起不再支持主进程断点，且该类型本质未适配v8 inspector协议；必须改用"type": "node"并显式添加--inspect=9229参数，才能正确建立调试连接。
VSCode 调试 Electron 主进程，核心不是选“electron”类型配置，而是把它当 Node.js 进程来 debug —— 用 type: "node" + 显式 --inspect=9229 启动 Electron 二进制，否则断点根本不会命中。
为什么 launch.json 里 type 不能写 electron
VSCode 的 "electron" 调试类型早在 Electron 12+ 就已弃用，且只支持旧版（--inspect，VSCode 就连不上调试器。
-
"type": "electron"配置在现代项目中基本无效，断点全灰、变量显示undefined、app变量找不到都是典型表现 - 必须用
"type": "node"，让 VSCode 直接控制 Node.js 运行时，再把 Electron 当作一个带参数的 Node 程序来跑 - 如果你用了
pwa-node，也请换回原生node类型——某些 Electron 版本下pwa-node会跳过require模块解析，导致作用域丢失
launch.json 必须写的几个关键字段
以下是最小可行配置，适用于未打包的纯 JS 项目（如 main.js 在项目根目录）：
{
"configurations": [
{
"type": "node",
"request": "launch",
"name": "Debug Main Process",
"runtimeExecutable": "${workspaceFolder}/node_modules/.bin/electron",
"args": ["--inspect=9229", "."],
"console": "integratedTerminal",
"sourceMaps": true,
"env": {
"ELECTRON_ENABLE_LOGGING": "true"
}
}
]
}
-
runtimeExecutable必须指向本地node_modules/.bin/electron（macOS/Linux）或node_modules/.bin/electron.cmd（Windows），不能用全局electron命令，否则版本错配会导致调试端口不响应 -
args中--inspect=9229必须在.之前，顺序颠倒（如[".", "--inspect=9229"]）会被 Electron 忽略 -
sourceMaps开启后，TypeScript 或打包项目才需要配outFiles；纯 JS 项目可删掉这一行，避免路径匹配失败干扰调试 -
ELECTRON_ENABLE_LOGGING环境变量能让你在终端看到 IPC、窗口创建等关键日志，比盲调试快得多
断点进了但 app 是 undefined？检查模块系统冲突
常见于你用了 TypeScript、Vite 或 ESM 风格的 import 写法，但 Electron 主进程默认以 CommonJS 模式加载 main.js。Node.js 加载机制冲突会让调试器无法识别模块作用域。
- 在断点处打开 VSCode 调试控制台，执行
typeof app：返回"undefined"基本确认是这个问题 - 临时验证方式：把
main.js改成纯require写法（比如const { app, BrowserWindow } = require('electron');），再试一次断点 - 若必须用 ESM（如配合 Vite），需在
package.json中加"type": "module"，并确保所有依赖（包括 preload）都兼容 ESM，否则require("electron")会报错
想同时调试主进程和渲染进程？别信“自动 attach”
VSCode 不会等窗口加载完再连渲染进程，Attach to Renderer 配置经常连不上，因为端口开了但页面还没 ready。
- 先确保启动命令显式加了
--remote-debugging-port=9222（和主进程的 9229 分开，避免冲突） - 在
createWindow()里win.loadURL()后立刻加win.webContents.openDevTools()，手动触发 DevTools 就绪信号 -
Attach to Renderer的webRoot必须指向 HTML 文件所在目录（如${workspaceFolder}/src），不是dist或构建后路径，否则源码映射失败 - 连接失败时，直接访问
http://localhost:9222/json查看是否返回页面列表 —— 没有返回说明 Electron 根本没启用该端口
Electron 主进程调试最常卡住的地方，从来不是配置写错，而是你以为它像网页一样“自动就绪”，其实它连调试协议都要你亲手拧开开关、对准端口、再推一把运行时。多一个 --inspect 参数，少一个 type: "electron"，差别就是断点停得住，还是永远灰着。
