VSCode调试Electron需分主进程与渲染进程：主进程用node类型+--inspect=9229+attach模式，渲染进程用pwa-chrome类型+--remote-debugging-port=9222+openDevTools()调用，二者协议不同、路径映射需准确、启动顺序须严格。
VSCode 调试 Electron 主进程和渲染进程，不是“配好就能用”，而是必须分进程、分协议、分时机来处理——主进程走 Node.js 调试协议（--inspect），渲染进程走 Chrome DevTools 协议（--remote-debugging-port），两者不能混用，也不能靠一个配置搞定。
主进程断点不生效？检查 --inspect 是否显式传入且位置正确
Electron 12+ 默认禁用 V8 调试协议，electron . 启动时不会自动开启调试端口。VSCode 的 node 类型调试器无法 attach 到未启用 inspect 的进程。
-
args中--inspect=9229必须写在.之前，例如["--inspect=9229", "."]；写成[".", "--inspect=9229"]会被 Electron 忽略 -
runtimeExecutable应指向本地安装的 Electron 二进制（如${workspaceFolder}/node_modules/.bin/electron），而非全局命令，避免版本错位 - 若用 TypeScript 或打包工具（如 electron-vite），确保
sourceMaps为true，且outFiles指向生成路径（如"${workspaceFolder}/dist/main.js"） - 常见错误现象：
app、BrowserWindow在断点处显示undefined→ 很可能是 ES Module 加载导致作用域隔离，临时验证可在调试控制台执行typeof app
渲染进程连不上？重点查 webContents.openDevTools() 和 webRoot
渲染进程本质是 Chromium 页面，VSCode 必须通过 Chrome Debug Protocol 连接，type 必须设为 chrome 或 pwa-chrome（VSCode 1.85+ 推荐后者），不能用 node。
- 代码中必须调用
win.webContents.openDevTools()（开发时），否则 DevTools 协议未激活，VSCode 无法发现可用目标 -
launch.json中若使用file://协议加载页面（如loadFile('index.html')），必须配置webRoot指向源码目录（如"${workspaceFolder}/src"），否则断点映射失败 - 推荐改用本地 HTTP 服务（如
http://localhost:3000），可绕过file://跨域限制和路径解析歧义 - 启动后访问
http://localhost:9222/json，能列出渲染页说明端口已就绪；返回空或 404 表示--remote-debugging-port=9222未生效或被占用
想同时调试主+渲染进程？用 compounds，但别指望“一键全停”
VSCode 不支持单个配置同时 attach 两个不同协议的进程。必须定义两个独立配置，并用 compounds 组合触发。
- 主进程配置：type =
node，request =attach，port =9229，protocol =inspector - 渲染进程配置：type =
pwa-chrome，request =attach，port =9222，webRoot 必须准确 - 启动顺序有依赖：先启动 Electron（带双参数），再手动触发 VSCode 的 compound debug；VSCode 不会等窗口创建完才连渲染进程，所以
openDevTools()要早于loadURL()或放在did-finish-load回调里 - 两个进程断点互不影响，但变量作用域完全隔离——你在主进程中看到的
ipcRenderer是 undefined，这正常；别试图在渲染进程断点里查主进程的app实例
launch.json 配置里最容易被忽略的三个细节
很多调试失败不是因为逻辑错，而是这几个硬性条件没对齐：
-
type值必须严格匹配协议：node对主进程，pwa-chrome对渲染进程；写成electron或pwa-node会静默失败 -
protocol字段在主进程 attach 模式下必须显式设为"inspector"（Electron 7+ 默认支持，但旧版 launch.json 模板可能缺） - Windows 下
runtimeExecutable要区分.cmd和非 Windows 路径，windows字段不能省，否则调试器找不到 electron.cmd
Electron 调试真正卡住的地方，往往不是“怎么配”，而是“哪个进程该用哪套协议”“什么时候端口才真正可用”“断点映射路径是否真实存在”。跨进程通信（IPC）问题尤其容易误判——主进程断点停住了，不代表渲染进程也同步停了；反过来也一样。盯住端口、协议、路径这三样，比反复重装插件管用得多。
