使用Deno 2.0+Next.js时VSCode断点无法生效的问题

核心问题分析 #

当前launch.json使用了node调试类型，但Deno有专属的调试适配器，同时启动参数和Next.js在Deno环境下的运行逻辑不匹配，导致断点无法映射到源文件。

修复步骤及配置调整 #

1. 切换调试类型为deno #

将配置中的"type": "node"改为"type": "deno"，VS Code需先安装Deno官方扩展（ms-vscode.vscode-deno）才能识别该类型。

2. 调整启动参数 #

Next.js在Deno环境下通过Deno的npm支持运行，直接用Deno的调试配置参数即可。修改后的launch.json如下：

{
  "version": "0.2.0",
  "configurations": [
    {
      "request": "launch",
      "name": "Deno + Next.js Dev",
      "type": "deno",
      "command": "run",
      "args": [
        "--unstable",
        "--inspect-brk=127.0.0.1:9229",
        "--allow-all",
        "npm:next",
        "dev"
      ],
      "cwd": "${workspaceFolder}",
      "sourceMaps": true,
      "resolveSourceMapLocations": [
        "${workspaceFolder}/**",
        "!**/node_modules/**"
      ],
      "console": "integratedTerminal"
    }
  ]
}

3. 关键配置说明 #

• type: "deno"：使用Deno官方调试适配器，确保正确解析Deno环境下的源文件与sourcemap
• args中直接传递npm:next dev：通过Deno的npm执行器调用Next.js的dev命令
• --inspect-brk=127.0.0.1:9229：明确指定调试端口，避免端口冲突
• resolveSourceMapLocations：限定sourcemap查找范围，排除node_modules，提升调试准确性

4. 额外检查项 #

• 确保已安装最新版Deno扩展
• 确认Next.js项目已适配Deno环境，package.json中的依赖能被Deno正确识别
• 调试前关闭其他占用9229端口的进程

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