webstorm 找不到 electron 命令是因不继承 shell path，需启用 shell integration（macos/linux）或配置 path（windows），主进程调试须指向 electron 可执行文件并设参数为.，渲染进程应改用 loadurl 拼绝对路径，类型提示需 @ts-check、mark as resources root 及正确 tsconfig。
WebStorm 找不到 electron 命令
根本不是 Electron 没装，而是 WebStorm 默认不读取 shell 的 PATH（比如 macOS 的 ~/.zshrc 或 Windows 的系统环境变量）。终端里能跑 electron --version，但 WebStorm 的 Terminal 或运行配置里报 command not found: electron，就属于这个情况。
解决方法分系统：
- macOS/Linux：打开
Preferences → Tools → Terminal，勾选Activate shell integration - Windows：确认安装 Node.js 时勾选了
Add to PATH；若用nvm-windows，建议从命令行启动 WebStorm（如start "WebStorm"） - 最稳通用方案：在项目根目录执行
npm install electron --save-dev，然后在 WebStorm 运行配置中把Node interpreter显式设为node_modules/.bin/electron（Windows 是node_modules\.bin\electron.cmd）
主进程断点不生效
直接新建一个 Node.js 运行配置、填 main.js，断点永远不触发——因为 Electron 主进程不是靠执行 JS 文件启动的，而是由 electron 可执行文件加载整个项目目录。WebStorm 按普通 Node.js 脚本跑，等于跳过了 Electron 初始化流程。
必须改用以下方式之一：
- 新建 Node.js 运行配置，
JavaScript file不填main.js，而是填本地electron可执行路径：node_modules/electron/dist/electron（macOS/Linux）或node_modules/electron/dist/electron.exe（Windows） -
Application parameters填.（一个英文点号），确保加载当前项目 - 若用
electron-vite，优先运行npm run dev，再用 WebStorm 的Attach to Node.js/Chrome连接localhost:9229 - 想第一行就中断？加参数
--inspect-brk=5858启动，再 Attach 到该端口
渲染进程白屏或 index.html 加载失败
常见错误是写 win.loadFile('index.html')，开发时路径解析失败——loadFile 的相对路径逻辑和打包后不一致，且不校验文件是否存在。
正确做法是：
- 改用
win.loadURL('file://' + path.join(__dirname, 'index.html'))，拼出绝对路径 - 加一行
console.log(path.join(__dirname, 'index.html'))验证路径是否真实存在 - 别右键
index.html → Open in Browser，那只是普通浏览器打开，不经过 Electron 加载流程，preload.js和nodeIntegration全部失效 - 检查
webPreferences：开发期需显式设nodeIntegration: true和contextIsolation: false，否则require报错、process访问不到
类型提示失效或 require 标红
装了 @types/electron，但 app、BrowserWindow 仍无提示，甚至 require 报红，问题不在类型定义本身，而在 WebStorm 对项目结构的识别。
三步修复：
- 在
main.js顶部加// @ts-check - 右键项目根目录 →
Mark Directory as → Resources Root - 确认
tsconfig.json中有"types": ["electron"]和"lib": ["es2020", "dom"]（即使不用 TypeScript，WebStorm 也依赖它做类型推导）
electron 加载、渲染进程由 Chromium 托管）缺乏开箱即用的适配。最容易被忽略的是：所有路径都得走 path.join(__dirname, ...) 拼绝对路径，所有调试入口都得指向 electron 可执行文件本身，而不是 main.js。
