Neovim DAP调试异步方法时无法跳过Node内部代码求助

问题核心 #

你在Jest/Mocha异步测试调试时，skipFiles配置无法忽略Node内部的promiseAfterHook、processTicksAndRejections等方法，但同步代码（如console.log）能正常跳过。这主要是Node异步方法的路径匹配规则和测试框架调试启动参数冲突导致的。

具体修复步骤 #

1. 修正调试启动参数的冲突 #

看你Mocha的配置，runtimeArgs里已经加了--inspect-brk，但args里又写了"inspect"，参数重复会干扰调试器的路径识别：

-- 原配置问题部分
runtimeArgs = {
    "--inspect-brk",
    "${workspaceFolder}/node_modules/mocha/bin/_mocha",
},
args = {"inspect", "${file}" }, -- 此处"inspect"多余，和--inspect-brk冲突

修改为：

runtimeArgs = {
    "--inspect-brk",
    "${workspaceFolder}/node_modules/mocha/bin/_mocha",
    "${file}" -- 把测试文件路径移到runtimeArgs中
},
args = {}, -- 清空args避免冲突

Jest配置里的--runInBand是必须的，能避免多进程调试冲突，无需修改。

2. 优化skipFiles匹配规则 #

<node_internals>/**是VS Code调试器的简写，但node2适配器对异步方法的路径匹配需要更精确的规则，补充对应文件的匹配：

skipFiles = {
    "<node_internals>/**",
    "node_modules/**",
    -- 补充Node内部异步方法所在文件的匹配
    "*/lib/internal/process/task_queues.js",
    "*/lib/internal/promise_hooks.js",
    "*/lib/internal/modules/cjs/loader.js"
}

3. 限定sourceMap解析范围 #

部分测试框架（如Jest）会生成自身的sourceMap，导致调试器误识别框架代码为用户代码。在Jest和Mocha的配置里添加以下项：

resolveSourceMapLocations = {
    "${workspaceFolder}/**",
    "!**/node_modules/**",
    "!**/<node_internals>/**"
}

这会让调试器只解析你项目目录下的sourceMap，忽略第三方和Node内部的。

4. 升级node2适配器 #

你手动下载的vscode-node-debug2已归档，存在兼容性问题。建议改用官方维护的npm包：

npm install -g @vscode/node-debug2

然后修改适配器路径：

dap.adapters.node2 = {
    type = "executable",
    command = "node",
    -- 全局安装路径示例，根据实际安装位置调整
    args = { "/usr/local/lib/node_modules/@vscode/node-debug2/out/src/nodeDebug.js" }
}

验证用的Jest完整配置示例 #

{
    name = "Jest (Node2 with ts-node)",
    type = "node2",
    request = "launch",
    cwd = vim.loop.cwd(),
    runtimeArgs = { "--inspect-brk", "${workspaceFolder}/node_modules/.bin/jest" },
    runtimeExecutable = "node",
    args = { "${file}", "--runInBand", "--coverage", "false" },
    sourceMaps = true,
    port = 9229,
    console = "integratedTerminal",
    skipFiles = {
        "<node_internals>/**",
        "node_modules/**",
        "*/lib/internal/process/task_queues.js",
        "*/lib/internal/promise_hooks.js"
    },
    resolveSourceMapLocations = {
        "${workspaceFolder}/**",
        "!**/node_modules/**",
        "!**/<node_internals>/**"
    }
},

额外提示 #

• 调试时用:DapShowLog查看日志，能确认哪些文件没被正确忽略
• TypeScript项目要确保tsconfig.json里sourceMap设为true，outDir配置正确

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