electron项目webstorm调试失败需适配双进程模型，提供五种方案：一、node.js配置指向electron可执行文件；二、electron-vite dev命令+attach调试；三、--inspect-brk强制首行断点；四、chrome devtools手动调试；五、修复渲染进程路径与上下文配置。
如果您已成功在WebStorm中搭建Electron项目，但主进程或渲染进程断点无法触发、调试器连接失败、控制台无输出或白屏，则很可能是调试配置未适配Electron特殊的双进程模型。以下是多种可独立生效的调试方案：
一、配置Node.js运行配置启动Electron主进程
该方法通过显式指定electron可执行文件路径，使WebStorm以Node.js模式正确加载主进程上下文，避免因误用普通Node.js配置导致main.js被直接执行而跳过Electron初始化流程。
1、打开WebStorm → Run → Edit Configurations… → 点击左上角“+” → 选择Node.js。
2、在JavaScript file字段中不填写main.js，而是填写本地electron可执行路径：node_modules/electron/dist/electron（macOS/Linux）或node_modules/electron/dist/electron.exe（Windows）。
3、在Application parameters中输入.（一个英文点号），表示当前项目根目录为Electron加载入口。
4、确认Node interpreter指向项目内node/bin/node（非全局），并勾选Allow running in parallel。
二、使用electron-vite内置dev命令配合Attach调试
该方法适用于采用electron-vite脚手架的项目，利用其预置的Inspector端口暴露机制，通过WebStorm Attach方式连接已启动的主进程，支持热重载与多入口断点。
1、确保项目已安装electron-vite：执行npm install electron-vite --save-dev。
2、在package.json中添加脚本："dev": "electron-vite dev"。
3、在WebStorm中新建运行配置 → 选择Attach to Node.js/Chrome → Host填localhost，Port填9229（electron-vite默认端口）。
4、先执行npm run dev启动项目，待控制台出现“Debugger listening on ws://127.0.0.1:9229/…”提示后，再运行WebStorm中的Attach配置。
三、启用--inspect-brk参数强制首行断点
该方法通过启动时挂起主进程，确保WebStorm可在应用初始化第一行即介入调试，解决常规--inspect无法捕获早期生命周期的问题。
1、修改package.json中的启动脚本，例如："debug-main": "electron --inspect-brk=5858 ."。
2、在WebStorm中新建Node.js配置，JavaScript file留空，Node parameters填入--inspect-brk=5858，Working directory设为项目根路径。
3、Application parameters仍为.，运行该配置后，主进程将在app模块加载前暂停。
4、此时打开Chrome浏览器访问chrome://inspect → 点击Configure → 添加localhost:5858 → 在Remote Target列表中点击inspect链接即可进入调试界面。
四、手动配置外部终端调试通道
该方法绕过WebStorm内置Node调试器，借助Chrome DevTools作为前端界面，WebStorm仅负责代码编辑与源码映射，适合调试器冲突或版本兼容异常场景。
1、在终端中执行：electron --inspect=5858 .（注意不要加-brk，否则需手动触发继续）。
2、启动Chrome，访问chrome://inspect → 点击Configure → 填入localhost:5858并保存。
3、等待约10–20秒，Remote Target区域将显示Electron Main Process条目 → 点击右侧inspect。
4、在DevTools的Sources面板中，按Ctrl+P（macOS为Cmd+P）搜索main.js，设置断点；同时在WebStorm中对应位置写入debugger语句亦可同步触发。
五、修复渲染进程白屏与preload.js加载失败
该方法聚焦于渲染进程无法加载HTML或Node API不可用的问题，核心在于路径解析与上下文隔离配置，直接影响调试时资源定位与API可用性。
1、在main.js中，将win.loadFile('index.html')替换为：win.loadURL('file://' + path.join(__dirname, 'index.html'))。
2、检查BrowserWindow构造选项中的webPreferences字段，必须包含：nodeIntegration: true, contextIsolation: false（开发阶段）。
3、若使用preload.js，在loadURL前添加：webPreferences: { preload: path.join(__dirname, 'preload.js') }。
4、在preload.js顶部加入console.log语句，并在main.js中添加：console.log(__dirname, path.join(__dirname, 'preload.js'))，比对实际路径是否匹配。
