主进程断点不生效是因为electron 12+默认禁用v8 inspector，必须显式添加--inspect=9229且置于args中"."之前，runtimeexecutable需指向本地electron二进制，同时启用electron_enable_logging日志便于排查。
主进程断点不生效？先确认 --inspect 参数位置和 runtimeExecutable
Electron 12+ 默认禁用 V8 Inspector，electron . 启动时根本不会暴露调试端口。VSCode 的 node 类型调试器只能 attach，不能自动注入协议——必须让 Electron 进程自己带上 --inspect=9229，且参数顺序不能错。
-
--inspect=9229必须写在.之前，例如["--inspect=9229", "."]；写成[".", "--inspect=9229"]会被 Electron 完全忽略 -
runtimeExecutable必须指向本地安装的 Electron 二进制：${workspaceFolder}/node_modules/.bin/electron（macOS/Linux）或${workspaceFolder}/node_modules/.bin/electron.cmd（Windows），不能用全局electron命令，否则版本错位导致端口无响应 - 加
"env": { "ELECTRON_ENABLE_LOGGING": "true" }，终端立刻输出窗口创建、IPC 注册等日志，比等断点快得多 - 若用 TypeScript 或
electron-vite，确认sourceMaps: true，并配outFiles: ["${workspaceFolder}/dist/main.js"]
渲染进程 DevTools 打不开或断点无效？别信 file:// 自动映射
渲染进程本质是 Chromium 页面，VSCode 必须通过 Chrome DevTools Protocol 连接，type 必须是 pwa-chrome（VS Code 1.85+ 推荐），不是 chrome 或 node。它不依赖 Electron 启动方式，而依赖页面是否就绪、端口是否暴露、路径是否可映射。
- 代码里必须调用
win.webContents.openDevTools({ mode: 'detach' })，且放在'ready-to-show'事件之后，否则窗口未就绪会报错 -
launch.json中url推荐用http://localhost:3000（对应 vite dev server），而非file://；若坚持用file://，必须配webRoot: "${workspaceFolder}/src"，否则断点找不到源文件 - 启动命令需同时带
--remote-debugging-port=9222（端口别跟主进程的 9229 冲突），访问http://localhost:9222/json应返回含devtoolsFrontendUrl的数组；空或 404 表示参数未生效或端口被占 - 避免加
--disable-features=OutOfBlinkCors等干扰 flag，这类参数会让 DevTools 加载失败或网络面板空白
双进程一起调试？靠 compounds 组合，但顺序和端口必须严格对齐
VSCode 不支持单条配置同时 attach 主进程和渲染进程。强行合并会导致端口冲突、子窗口无断点、调试器反复重连。compounds 不是并发启动，而是「先拉起主进程 → 等它创建好 BrowserWindow → 再附加到渲染端口」。
- 定义两个独立配置：一个
type: "node"（主进程，request: "attach"，port: 9229），一个type: "pwa-chrome"（渲染进程，request: "attach"，port: 9222） - 两个配置的
name要区分清楚，比如"Debug Main Process"和"Attach to Renderer" -
compounds项中按顺序列出它们："configurations": ["Debug Main Process", "Attach to Renderer"]，VSCode 会先启动主进程调试，等它就绪后再连渲染端口 - 主进程配置里不要加
--remote-debugging-port参数（它只管自己），该参数应统一放在package.json启动命令中，由 Electron 统一传递
为什么 compound 启动后渲染进程断点还是灰色？检查 webContents 是否已加载完成
VSCode 的 pwa-chrome attach 是轮询端口，但只有页面进入 did-finish-load 状态后，DevTools 协议才真正可用。断点灰掉，大概率不是配置错，而是时机没卡准。
- 确保
win.loadURL()已执行，且页面已完成加载；可在win.webContents.on('did-finish-load', () => { ... })里触发openDevTools()做验证 - 如果用
loadFile('index.html')，注意webRoot必须精确指向 HTML 所在目录，比如"${workspaceFolder}/src"，而不是项目根目录 - React/Vue 组件调试需额外安装对应 DevTools：用
electron-devtools-installer，且installExtension必须在app.whenReady()之后调用 - 常见错误现象：
app、BrowserWindow在断点处显示undefined→ 很可能是 ES Module 加载导致作用域隔离，临时验证可在调试控制台执行typeof app
