VS Code打开后首次启动Node.js调试器失败求助

针对你遇到的首次按F5启动Node.js调试器失败、重启后恢复正常的情况，可尝试以下排查和修复方案：

1. 确认预启动任务配置完整性 #

你的launch.json指定了preLaunchTask: "tsc: build - tsconfig.json"，但如果VS Code自动生成的tasks.json存在配置缺失，可能导致预编译任务未正确完成，进而让调试器找不到编译后的文件。

检查.vscode/tasks.json是否存在，若缺失则手动创建，确保配置如下：

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "typescript",
      "tsconfig": "tsconfig.json",
      "problemMatcher": ["$tsc"],
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "label": "tsc: build - tsconfig.json"
    }
  ]
}

保证label与launch.json中的preLaunchTask完全一致，且problemMatcher配置正确，让VS Code能准确识别任务是否完成。

2. 优化调试配置的路径与映射 #

在launch.json的配置中添加resolveSourceMapLocations字段，帮助调试器精准定位sourcemap文件：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Program",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/helloworld.ts",
      "preLaunchTask": "tsc: build - tsconfig.json",
      "outFiles": ["${workspaceFolder}/out/**/*.js"],
      "resolveSourceMapLocations": ["${workspaceFolder}/out/**", "!**/node_modules/**"]
    }
  ]
}

3. 手动触发预编译再调试 #

首次打开VS Code后，先按Ctrl+Shift+B触发TypeScript编译任务，确认out目录生成对应的.js和.js.map文件后，再按F5启动调试。若此方式能正常启动，说明预启动任务首次执行时存在延迟或触发异常。

4. 清理缓存并重置配置 #

• 删除out目录下所有文件，重新执行编译
• 关闭VS Code后，删除.vscode/launch.json和.vscode/tasks.json，通过VS Code的"创建launch.json文件"向导重新生成配置
• 升级VS Code到最新版本，或更新TypeScript插件（1.76.0版本存在部分调试相关已知bug，升级后可能解决问题）

5. 验证工作区路径正确性 #

确认${workspaceFolder}指向项目根目录（即包含tsconfig.json的目录），可在调试控制台执行console.log(__dirname)验证路径是否匹配预期。

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