WebStorm 识别不了 electron 全局命令的根本原因是默认不读取 shell 的 PATH（如 macOS/Linux 的 ~/.zshrc），需启用 Terminal 的 Shell integration；主进程调试需用 electron 可执行路径而非 main.js；渲染进程白屏多因 loadFile 路径错误，应改用 loadURL 并验证实际路径；类型提示失败则需添加 // @ts-check、标记 Resources Root 并配置 tsconfig.json 的 types 和 lib。
WebStorm 识别不了 electron 全局命令
根本原因不是 WebStorm 配置问题，而是它默认不读取 shell 的 PATH（尤其 macOS/Linux 的 ~/.zshrc 或 ~/.bash_profile）。即使终端里能跑 electron --version，WebStorm 的 Terminal 或运行配置里可能报 command not found: electron。
- 打开 WebStorm → Preferences → Tools → Terminal，勾选
Shell path下的Activate shell integration（macOS/Linux 必开） - Windows 用户确认已安装 Node.js 并勾选了
Add to PATH；若用 nvm，需在 WebStorm 启动前通过终端启动（如open -a "WebStorm.app"） - 更稳妥的做法：在项目根目录下用
npm install electron --save-dev，然后在 WebStorm 运行配置中把 Node interpreter 设为项目内node_modules/.bin/electron（路径要写全）
Electron 主进程调试断点不生效
WebStorm 默认按 Node.js 模式调试，但 Electron 主进程启动方式特殊——它不是直接执行 main.js，而是由 electron 可执行文件加载，所以普通 Node.js 运行配置会跳过主进程。
- 必须新建一个
Node.js运行配置，但JavaScript file不填main.js，而是填你本地安装的electron可执行路径（如node_modules/electron/dist/electron或全局路径） -
Application parameters填.（当前目录），确保 Electron 加载的是本项目 - 如果用了
electron-builder或electron-vite，优先用它们提供的调试脚本（如npm run dev），再用 WebStorm 的Attach to Node.js/Chrome配置连接到运行中的主进程（端口通常是9229）
渲染进程调试时找不到 index.html 或白屏
Electron 渲染进程本质是 Chromium，但 WebStorm 不会自动托管静态资源。如果你用 win.loadFile('index.html')，路径是相对于打包后结构的；而开发时直接运行，路径容易错位。
- 确保
main.js中加载 HTML 用的是win.loadURL('file://' + path.join(__dirname, 'index.html'))，而不是loadFile（后者对相对路径更敏感） - 在 WebStorm 中右键
index.html→Open in Browser是无效的——必须通过 Electron 启动才能触发preload.js、Node.js API 等上下文 - 检查控制台是否报
Failed to load resource: net::ERR_FILE_NOT_FOUND，大概率是path.join拼错了路径，建议加一句console.log(__dirname, path.join(__dirname, 'index.html'))确认实际路径
WebStorm 自动导入 electron 类型提示失败
即使装了 @types/electron，WebStorm 有时仍标红 app、BrowserWindow，不是类型没装，而是没告诉 IDE 哪个文件属于主进程上下文。
- 在
main.js（或main.ts）顶部手动加一行注释：// @ts-check（JS）或确保 tsconfig.json 中"checkJs": true - 右键项目根目录 →
Mark Directory as → Resources Root，避免 WebStorm 把node_modules/electron当作纯前端包处理 - 如果用 TypeScript，确认
tsconfig.json的types字段包含"electron"，且没有误删lib中的dom（渲染进程需要）和node（主进程需要）
Electron 开发里最耗时间的往往不是写代码，而是路径拼错、进程上下文混淆、调试端口没连上——这些细节 WebStorm 不会主动提醒，得靠日志和 console.log 一点点对齐主/渲染进程的真实执行环境。
