webstorm调试node.js必须正确填写javascript file字段，否则报“找不到主模块”或调试立即退出；应填相对项目根目录的可require路径（如src/index.js），不可填package.json或.ts文件，npm启动则改用npm配置并填start脚本。
Node.js 运行配置必须填对 JavaScript file
WebStorm 不会自动猜入口文件，JavaScript file 字段留空或填错路径，直接导致“找不到主模块”或调试启动后立刻退出。常见错误是填了 package.json 或只写文件名（如 index.js），而没写相对项目根目录的完整路径。
- 正确写法示例：
src/index.js、bin/www、dist/main.js - 路径必须可被 Node.js 直接 require —— 不能是 TypeScript 源文件（如
src/index.ts），除非你已配好 ts-node 或构建流程 - 如果项目用
npm start启动，别在 Node.js 配置里硬填 JS 文件，改用npm模板，再填start脚本名 - 点击右侧文件夹图标可弹出项目树选择，比手输更安全
前端 HTML 调试必须启用 JavaScript Debugger for Chrome
点 Debug ‘index.html’ 没反应？大概率是插件没开或 Chrome 扩展没装。WebStorm 的 JavaScript Debug 配置依赖两个独立组件：IDE 内置开关 + 浏览器端扩展，缺一不可。
- 先确认设置里已启用：
Settings → Tools → Browser Development Tools → Enable JavaScript debugger for Chrome - 再装 Chrome 插件：
JetBrains IDE Support（仅从 Chrome Web Store 安装，第三方打包版常失效） - 调试时 WebStorm 会新开一个无痕 Chrome 窗口，书签/登录态都不继承 —— 别误以为连不上，这是正常行为
- 如果断点灰掉（无法命中），检查 HTML 中 script 标签是否含
type="module"或用了import，这类代码需确保服务启用了 ES modules 支持
断点不生效？先看 Allow parallel run 和源码映射
尤其对 TypeScript 或打包后的项目，断点打在 .ts 文件却停在 .js 上，或反复重启后断点消失，通常不是 IDE bug，而是配置链断裂。
- TS 项目必须勾选
Enable source maps（在tsc --build或 webpack/vite 配置中），且 WebStorm 的 Node.js 配置里要指向生成的.js文件，不是.ts -
Allow parallel run不勾选时，第二次 Debug 会杀掉前一个进程 —— 看似“断点失效”，其实是旧会话被强制终止 - 临时配置最多存 5 个，老配置自动丢弃；想复用务必点
Save Configuration变成永久配置，图标从半透明变实心 - 调试 Svelte/Vue/React 组件时，断点可能因 HMR 热更新失效，建议首次调试前关掉开发服务器，纯用 WebStorm 启动
内置服务器端口冲突会导致 URL 配置失败
JavaScript Debug 配置里的 URL 字段写 http://localhost:63342/myapp/index.html 却打不开页面？问题往往不在 URL 本身，而在端口没跑起来。
- WebStorm 内置服务器默认端口是
63342，但若该端口被 Docker、其他 IDE 或杀毒软件占用，服务器根本不会启动 - 查端口是否就绪：打开
Settings → Tools → Web Browsers and Preview → Built-in server port，换一个 >1024 的数（比如8080），再同步改URL字段 - 本地文件调试时，
URL必须以http://开头，不能用file://—— 否则跨域或调试器拒绝连接 - 修改端口后，重启 WebStorm 才生效，单纯重载项目不管用
