WebStorm调试器无法在断点处停止的问题求助

以下是针对你的环境（Node v20.18、TypeScript v5.5.4、ts-node v10.9.2）的具体修复步骤：

1. 确保tsconfig.json启用SourceMap #

断点依赖源映射文件关联TypeScript源码与编译后的JavaScript，必须在tsconfig.json中开启核心配置：

{
  "compilerOptions": {
    "sourceMap": true,  // 必须设为true，否则断点无法关联源码
    "outDir": "./dist", // 建议明确输出目录，便于WebStorm识别映射关系
    "module": "CommonJS" // 若项目用ES模块，改为"ESNext"并配合后续配置调整
    // 其他原有配置保持不变
  }
}

2. 修改npm start脚本的调试参数 #

在package.json的scripts中添加调试标识，确保ts-node生成可被调试器识别的源映射：

{
  "scripts": {
    // --inspect-brk会在启动时暂停，方便捕获初始化代码；仅需附加调试可改用--inspect
    "start": "ts-node --inspect-brk src/index.ts"
    // 若项目启用ES模块（package.json中含"type": "module"），需改用ts-node-esm：
    // "start": "ts-node-esm --inspect-brk src/index.ts"
  }
}

3. 手动创建WebStorm调试配置（替代自动生成） #

自动生成的配置可能存在兼容性问题，手动配置更可靠：

• 打开Run > Edit Configurations，点击+选择Node.js
• 在Configuration标签页：
  • 设置JavaScript file为node_modules/ts-node/dist/bin.js（ES模块项目选node_modules/ts-node/dist/bin-esm.js）
  • 在Application parameters中填入你的入口文件路径，比如src/index.ts
• 切换到Logs标签页，勾选Show console when stdout changes，便于查看调试日志

4. 检查WebStorm的TypeScript与调试设置 #

• 打开Settings > Languages & Frameworks > TypeScript，确保TypeScript version选择项目本地的v5.5.4（而非WebStorm内置版本）
• 打开Settings > Build, Execution, Deployment > Debugger > Stepping，取消勾选Skip library code（若需调试依赖库代码），并确认TypeScript文件未被排除在调试范围外
• 若断点显示为灰色，右键断点选择More，检查Source是否正确关联到你的TS源码文件

5. 清理WebStorm缓存并重启 #

缓存可能导致源映射关联失效：

• 执行File > Invalidate Caches...
• 勾选Clear file system cache and local history，点击Invalidate and Restart

6. ES模块项目额外配置 #

如果项目启用ES模块（package.json含"type": "module"），需补充：

• tsconfig.json中moduleResolution设为"bundler"或"NodeNext"
• 确保WebStorm调试配置的Node parameters中添加--experimental-specifier-resolution=node（若遇到模块解析问题）

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