VSCode调试Jest测试时模块导入失败，求调试根目录配置方案

VSCode调试Jest时，确实需要单独在调试配置里同步模块解析规则——因为Node调试器不会自动读取Jest配置里的moduleDirectories这类路径设置，这就是为什么测试能正常运行但调试报错的核心原因。

具体配置步骤 #

• 打开VSCode调试面板（按Ctrl+Shift+D），点击「创建launch.json文件」，选择「Node.js」环境。
• 在生成的launch.json中，用以下两种方式之一配置，让调试器和Jest使用相同的路径解析规则：

方式一：通过NODE_PATH指定src根目录 #

直接给Node调试器设置模块解析根路径，和Jest配置对齐：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Jest Debug",
      "type": "node",
      "request": "launch",
      "program": "${workspaceRoot}/node_modules/jest/bin/jest.js",
      "args": ["--runInBand"],
      "env": {
        "NODE_PATH": "${workspaceRoot}/src"
      },
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}

NODE_PATH会告诉Node调试器把src当作模块查找的根目录，这样import 'components/Modal'就能被正确识别。

方式二：直接复用Jest配置文件 #

如果你的Jest配置写在jest.config.js或package.json里，直接在调试参数里指定使用该配置，确保调试和运行时规则完全一致：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Jest Debug",
      "type": "node",
      "request": "launch",
      "program": "${workspaceRoot}/node_modules/jest/bin/jest.js",
      "args": ["--runInBand", "--config", "${workspaceRoot}/jest.config.js"],
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen"
    }
  ]
}

关键注意事项 #

• 确认${workspaceRoot}指向你的项目根目录（也就是Jest配置里rootDir: '../'对应的目录），如果VSCode打开的是子目录，把路径改成${workspaceFolder}/..即可。
• --runInBand必须添加，因为Jest默认并行运行测试，调试器无法处理多进程调试场景。

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