NX创建的NestJS项目在WebStorm中调试失败求助

方法1：手动配置Node.js调试项 #

• 打开WebStorm右上角运行按钮旁的下拉菜单，选择Edit Configurations
• 删除自动生成的NX调试配置
• 新建Node.js类型配置：
  • 在JavaScript file字段填入项目入口文件路径，比如apps/[你的Nest应用名]/src/main.ts
  • Working directory选择对应应用的根目录（如apps/[你的Nest应用名]）
  • Environment variables添加NODE_ENV=development，也可直接复制package.json中start命令的环境变量
  • Before launch步骤添加nx build [你的Nest应用名]，确保调试前完成编译
• 保存后启动该配置，断点即可正常触发

方法2：自定义npm调试脚本 #

• 在项目根目录的package.json中添加调试脚本：

  "scripts": {
    "debug:my-app": "nx serve my-app --inspect-brk"
  }
  

• 在WebStorm中右键该脚本，选择Debug直接启动调试

方法3：排查插件与配置冲突 #

• 打开WebStorm的Settings/Preferences（File -> Settings），找到Plugins，暂时禁用NX插件后重启WebStorm
• 用普通Node.js调试配置启动项目，确认调试正常后，再重新启用NX插件，排查是否为插件自动配置冲突
• 检查Settings/Preferences -> Languages & Frameworks -> Node.js and NPM，确认Node.js解释器配置正确，未误选deno

额外排查点 #

• 确认nx.json中对应应用的targets配置里，serve命令的executor是@nx/nest:serve，而非deno相关执行器
• 清理WebStorm缓存：File -> Invalidate Caches...，选择Invalidate and Restart，解决缓存导致的配置异常

内容的提问来源于stack exchange，提问作者Arnaud Denoyelle