直接点击右上角绿色虫图标可启动调试，前提是有合法 package.json 脚本或已配置 node.js 运行配置；若无响应，需在 run → edit configurations 中新建 node.js 配置，javascript file 填绝对路径入口文件，或选 npm 类型填 scripts 为 start。
怎么启动 WebStorm 的 Node.js 调试会话
直接点右上角绿色小虫图标（Debug）就能启动，但前提是项目里得有合法的 package.json 脚本或已配置好 Node.js 运行配置。如果点下去没反应或报错，大概率是没配运行目标。
- 检查
Run → Edit Configurations…里有没有类型为Node.js的配置；没有就点+新建一个 -
JavaScript file字段必须填入口文件的**绝对路径**（比如/Users/me/project/index.js），不能写相对路径或node index.js - 如果用
npm start启动，选NPM类型配置，Scripts填start，别在Command里手动输npm run start—— WebStorm 会自己加 - 调试时 WebStorm 默认启用
--inspect，但如果你的 Node 版本 Use --debug-brk instead of --inspect
断点不命中？常见原因和验证方法
点了断点却不停，不是 WebStorm 抽风，多数是源码映射或执行路径没对上。尤其用 TypeScript、Babel 或打包工具时，原始 .ts 文件上的断点根本不会触发。
- 确认代码确实是被调试器加载的：在
Debug Console里输process.argv，看实际执行的是哪个文件路径 - TypeScript 项目必须生成
.js.map文件，且tsconfig.json中sourceMap设为true；WebStorm 才能将断点映射回.ts - 用
webpack打包后调试，需确保devtool: 'source-map'（不是eval-source-map），否则断点位置错乱 - 如果用了
nodemon，别在配置里直接写nodemon index.js—— 它会 fork 子进程，调试器连不上；改用nodemon --inspect-brk并在 WebStorm 配置中禁用自动--inspect
调试时变量显示 undefined 或值不更新
这不是变量真没了，而是作用域或优化导致调试器读不到实时值。Node.js 的 V8 在 debug 模式下仍可能做轻量级优化，尤其箭头函数、内联常量或未使用的变量。
- 在
Debug工具窗口的Watches栏里手动加表达式，比如typeof myVar或JSON.stringify(myObj)，比光看Variables面板更可靠 - 避免在
for循环里打太多断点——V8 可能跳过某些迭代的帧信息，导致局部变量消失 - 如果某变量始终显示
undefined，检查它是否在闭包外被提前释放（比如异步回调里引用了已被 GC 的对象） - WebStorm 默认关闭
Enable value tooltip on code hover，想悬停看值，去Settings → Build → Debugger → Data Views开启
远程调试 Node.js（比如 Docker 或服务器）怎么连
WebStorm 不支持直接 attach 到任意远程 --inspect 端口，必须通过端口转发或代理。本地连不上 localhost:9229，往往是因为服务跑在容器里没暴露端口，或防火墙挡了。
- Docker 启动时加
-p 9229:9229，Node 命令加--inspect=0.0.0.0:9229（不能只写--inspect，默认绑定127.0.0.1） - WebStorm 配置选
Attach to Node.js/Chrome，Host 填localhost，Port 填本地映射端口（如9229） - 如果服务器有防火墙，确保
9229端口入站放行；但别把--inspect直接暴露到公网，有安全风险 - attach 模式下无法在代码加载前设断点（比如
require链开头），只能等进程起来后再手动 pause 或在后续逻辑打点
最麻烦的其实是路径映射：WebStorm 本地代码路径和容器内路径不一致时，得在 Attach 配置里手动设置 Path mappings，把 /app/src → /Users/me/project/src 这类对应关系填清楚，不然断点还是不生效。
