如何在Visual Studio中调试Node.js项目的TypeScript单元测试？

你遇到的核心问题确实是源映射没有被单元测试运行器正确识别，导致VS无法将编译后的JS断点映射回TS源码。下面是一步步的实用解决方法：

1. 确保TypeScript编译生成正确的源映射 #

首先检查你的tsconfig.json，确认以下关键配置项正确设置：

{
  "compilerOptions": {
    "sourceMap": true,  // 必须开启，生成与.ts对应的.js.map源映射文件
    "outDir": "./dist", // 指定编译后JS文件的输出目录，方便调试器定位
    "rootDir": "./src", // 源码根目录，与outDir对应，保证源映射路径准确
    "target": "ES6",    // 选择兼容你当前Node.js版本的目标语法
    "module": "CommonJS"// Mocha默认支持CommonJS模块规范
  },
  "include": ["src/**/*"] // 包含所有源码和测试文件
}

修改后重新编译TypeScript，确认dist目录下同时生成.js和.js.map文件。

2. 配置Mocha以支持TypeScript和源映射 #

有两种便捷方式让Mocha正确处理TypeScript代码：

方式一：用ts-node直接运行TS测试（推荐） #

先安装必要的开发依赖：

npm install --save-dev ts-node typescript @types/mocha @types/node

运行测试时，通过ts-node加载Mocha，它会实时编译TS并自动处理源映射：

npx mocha -r ts-node/register src/day2-test.ts

这种方式无需提前手动编译TS，调试体验更流畅。

方式二：为预编译代码加载源映射支持 #

如果坚持先编译再运行测试，需要安装source-map-support让Node.js识别源映射：

npm install --save-dev source-map-support

然后在测试文件的最顶部添加引入：

import 'source-map-support/register';
// 其他导入代码...

3. 配置Visual Studio的调试启动项 #

在项目根目录创建.vscode/launch.json，添加Mocha专属调试配置：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "Mocha Tests",
      "program": "${workspaceFolder}/node_modules/mocha/bin/mocha",
      "args": [
        "-r", "ts-node/register", // 用ts-node处理TS测试文件
        "${workspaceFolder}/src/day2-test.ts"
      ],
      "skipFiles": [
        "<node_internals>/**"
      ],
      "sourceMaps": true, // 强制开启源映射支持
      "outFiles": ["${workspaceFolder}/dist/**/*.js"] // 编译后JS文件路径，用ts-node时可忽略
    }
  ]
}

配置完成后，在VS的调试面板选择Mocha Tests启动调试，就能正常命中TS源码的断点了。

额外小提示：修复单元测试的断言错误 #

你的测试代码里有个容易忽略的问题：用assert.equal对比数组是错误的——equal是引用相等比较，两个空数组是不同的对象，会导致测试失败。应该改用assert.deepEqual做深度比较：

it("empty or whitespace string returns empty array", () => {
  assert.deepEqual(Array.from(day2.lineToNumbers("")), []);
  assert.deepEqual(Array.from(day2.lineToNumbers(" ")), []);
});

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