VS Code默认调试功能对Node.js应用无效的原因是什么？

• 调试配置文件（launch.json）错误
  这是最常见的问题。比如program字段路径指向错误，或者未针对TypeScript、ES模块等场景配置正确参数：

  • 确保program指向项目入口文件，比如"program": "${workspaceFolder}/src/index.js"；
  • 如果用TypeScript，需配置runtimeExecutable为ts-node，并指定args或outFiles指向编译产物；
  • 检查env变量是否覆盖了必要的调试环境参数。

• Node.js版本兼容性问题
  旧版Node.js（如v10及以下）可能不支持VS Code调试器使用的Inspector协议，或者新版Node的调试端口配置与VS Code默认设置冲突：

  • 升级Node.js到LTS稳定版本；
  • 若使用nvm等版本管理工具，确保VS Code终端使用的Node版本与调试器指定的一致。

• 应用启动冲突

  • 若已手动通过终端启动了应用，调试器无法附加到运行中的进程，需先关闭所有相关Node进程；
  • 若package.json的start命令包含--inspect或--inspect-brk参数，会占用调试端口，导致VS Code调试器无法连接，需移除这些参数，让调试器自动注入调试标识。

• 工作区目录不正确
  VS Code打开的目录不是项目根目录时，${workspaceFolder}变量会指向错误路径，导致调试配置无法找到入口文件：

  • 重新打开项目根目录；
  • 或在launch.json中使用绝对路径替代变量（不推荐，建议规范工作区）。

• 调试插件异常

  • 检查VS Code扩展市场中的「Node.js」插件是否启用，若被禁用需重新启用；
  • 卸载其他可能冲突的第三方调试插件，避免协议冲突。

• 代码阻塞或启动失败
  若应用在启动阶段就崩溃或进入无限循环，调试器无法完成连接：

  • 先在终端运行node 入口文件路径，确认应用能正常启动；
  • 排查代码中的语法错误、未捕获异常，修复后再尝试调试。

内容的提问来源于stack exchange，提问作者Md. Nazmul Hasan