webstorm调试node.js需先配置合法运行配置：javascript file必须填绝对路径，node interpreter须手动指定真实路径，且typescript项目需启用sourcemap；否则断点不命中、变量undefined或启动失败。
WebStorm 调试 Node.js 不是点一下绿色虫子就完事的——它必须先认得你的入口文件、Node 解释器和执行路径，三者缺一不可；否则断点不命中、变量显示 undefined、甚至根本启动失败，都是配置没对齐的直接结果。
Node.js 运行配置里 JavaScript file 必须填绝对路径
相对路径（如 ./index.js 或 bin/www）在 WebStorm 的 Node.js 配置中会被忽略或解析失败，尤其在跨平台或项目结构嵌套时。WebStorm 不走 shell 环境，也不自动补全工作目录前缀。
- 打开
Run → Edit Configurations…，新建或选中一个Node.js类型配置 - 在
JavaScript file栏中，**手动输入完整绝对路径**，例如：/Users/you/project/src/index.ts或C:\dev\myapp\server.js - 别依赖“浏览”按钮自动补全——它有时会拼错路径层级，尤其在符号链接或 monorepo 中
- 如果用 TypeScript，确保该路径指向已编译的
.js文件（除非你启用了ts-node并单独配置了 Node 参数）
调试时断点不触发？先查 process.argv 和 source map
断点“看起来设上了”，但代码跑过去完全不停——大概率是调试器加载的不是你编辑的那份代码，或者源码映射失效。
- 启动调试后，在
Debug Console里直接输入process.argv，确认实际执行的是哪个文件路径；如果显示的是node_modules/.bin/nodemon或打包后的dist/index.js，那你打在src/下的断点天然无效 - TypeScript 项目必须在
tsconfig.json中明确设置"sourceMap": true，且生成的.js.map文件要和.js同目录 - 用 webpack 打包调试时，
devtool必须是'source-map'（不是'eval-source-map'或'cheap-module-source-map'），否则断点位置偏移 - 禁用 WebStorm 的
Enable JavaScript source maps选项（在Settings → Languages & Frameworks → JavaScript → Debugging）会导致 .map 文件被无视
用 nodemon 调试必须改配置，不能直接写命令
在 JavaScript file 里填 nodemon index.js 是常见错误：WebStorm 会把它当做一个 JS 文件去执行，而 nodemon 是 CLI 工具，不是可 require 的模块。
- 正确做法是：创建一个
Attach to Node.js/Chrome类型的配置，而不是Node.js类型 - 先在终端手动运行：
nodemon --inspect-brk=9229 index.js（端口可自定义） - 再在 WebStorm 中新建
Attach to Node.js/Chrome配置，填入对应Host（通常是localhost）和Port（如9229） - 勾选
Auto reconnect，这样 nodemon 重启进程后，WebStorm 会自动重连调试器 - 不要在
Node.js配置里勾选Use --inspect——它和--inspect-brk冲突，会导致调试器连不上
package.json 脚本调试失败，优先选 NPM 类型配置
想调试 "start": "node index.js" 这类脚本，别在 Node.js 配置里硬凑参数，也别在 Command 字段手输 npm run start。
- 新建配置时选类型为
NPM，不是Node.js -
Scripts字段填start（只写脚本名，不加run） -
Package.json字段指向你项目的package.json路径（通常自动识别） - WebStorm 会自动注入
node和npm环境，包括PATH和node_modules/.bin下的 bin，比手动配Node.js配置更稳 - 如果脚本依赖环境变量（如
NODE_ENV=development），在配置的Environment variables里加，别指望 shell 启动时带进来
最常被跳过的其实是 Node.js 解释器路径本身——WebStorm 不读系统 PATH，哪怕终端里 which node 能返回结果，IDE 里仍可能用错版本或根本找不到。每次换 nvm 版本、升级 Node 或切到新机器，第一件事就是去 Settings → Languages & Frameworks → Node.js and NPM 里核对 Node interpreter 字段是否指向真实可用的二进制。
