为什么VSCode调试TypeScript时直接用node运行TS文件而非先编译为JS

数据老陈

2026-10-2

问题原因

核心错误是launch.json中program字段直接指向了.ts源文件：preLaunchTask仅负责提前执行tsc编译，但program参数才是指定node实际运行的入口文件，你配置里直接填TS文件，node自然会直接尝试运行TS，不会自动去找编译后的JS。outFiles参数的作用是让VS Code调试器建立TS源码和编译后JS的映射关系，用来匹配断点，不是指定运行文件。
你的tsconfig.json未开启sourceMap配置，就算后续配置正确，调试器也无法将编译后JS的执行位置对应到TS源码的断点上。
tsconfig.json中module设为es2020，Node.js默认以CommonJS规范加载模块，直接运行ES模块会报错，需要调整配置或者额外加启动参数。

修正方案

1. 调整tsconfig.json

在compilerOptions中增加sourceMap: true，将module改为CommonJS：

{
  "compilerOptions": {
    "target": "es2017",
    "module": "CommonJS", /* 适配Node.js默认的模块加载规范 */
    "outDir": "./out",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "sourceMap": true /* 开启源码映射，支持TS断点调试 */
  }
}

2. 调整launch.json

将program字段改为指向编译后的JS文件，路径统一用正斜杠避免Windows平台转义问题：

{
    "version": "0.2.0",
    "configurations": [
        {
            "type": "node",
            "request": "launch",
            "name": "Launch Program",
            "skipFiles": [
                "<node_internals>/**"
            ],
            "program": "${workspaceFolder}/out/CheckFMBackup.js", /* 改为编译后的JS文件路径 */
            "outFiles": [
                "${workspaceFolder}/out/**/*.js"
            ],
            "preLaunchTask": "tsc: build - tsconfig.json"
        }
    ]
}