如何在VS Code中调试TypeScript Node.js服务器？

问题根源 #

你遇到的语法错误是因为Node.js本身不支持TypeScript语法，调试器直接尝试执行.ts文件，自然会把类型注解:当成非法语法。下面给你两种可行的配置方案，选一种就行。

方案一：预编译TS为JS后调试（传统方式） #

这种方式需要先把TS编译成JS，再调试生成的JS文件，依赖sourceMap关联TS源码。

1. 调整tsconfig.json #

给TS指定编译输出目录，避免源码和编译文件混在一起：

{
  "compilerOptions": {
    "composite": true,
    "module": "commonjs",
    "sourceMap": true,
    "baseUrl": ".",
    "types": ["node"],
    "paths": {
      "@/*": ["./src/*"]
    },
    "target": "es2016",
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true,
    "outDir": "./dist" // 新增：指定编译后的JS输出到dist目录
  },
  "include": ["src/**/*", "app.ts"] // 确保要编译的文件都被包含
}

2. 修改launch.json #

让调试器指向编译后的JS文件，同时关联sourceMap：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch Compiled JS",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}\\dist\\app.js", // 指向编译后的JS文件
      "outFiles": ["${workspaceFolder}/dist/**/*.js"], // 指定编译输出目录
      "preLaunchTask": "tsc: build - tsconfig.json" // 调试前自动执行TS编译任务
    }
  ]
}

3. 配置自动编译任务 #

按Ctrl+Shift+B选择tsc: build，之后每次调试前VS Code会自动把TS编译到dist目录。

方案二：用ts-node直接调试TS（开发更高效） #

这种方式不需要预编译，直接用ts-node运行TS文件，同时支持断点调试，适合开发阶段快速迭代。

1. 安装依赖 #

先在项目里安装必要依赖：

npm install -D ts-node typescript

2. 修改launch.json #

直接配置调试器用ts-node执行TS文件：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Launch TS with ts-node",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}\\app.ts",
      "runtimeArgs": ["--require", "ts-node/register"], // 用ts-node注册TS处理器
      "sourceMaps": true,
      "cwd": "${workspaceFolder}",
      "protocol": "inspector"
    }
  ]
}

注意事项 #

• 确保tsconfig.json里sourceMap已设为true，断点才能正确映射到TS源码。
• 方案二调试时无需手动编译，ts-node会实时处理TS文件。

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