解决nvim-dap中JavaScript调试适配器配置问题

问题背景

在使用nvim-dap进行JavaScript/TypeScript项目调试时，用户可能会遇到"adapter.port is required for server adapter"的错误提示。这个问题通常发生在更新了nvim-dap插件版本后，特别是在使用vscode-js-debug适配器时。

问题分析

这个问题的根源在于某些第三方插件(如nvim-dap-vscode-js)使用了nvim-dap未公开的内部API，而这些API在新版本中发生了变化。当插件维护不及时时，就会导致兼容性问题。

解决方案

直接配置调试适配器

最可靠的解决方案是绕过第三方插件，直接配置调试适配器。对于JavaScript/TypeScript项目，可以这样配置：

require("dap").adapters["pwa-node"] = {
  type = "server",
  host = "localhost",
  port = "${port}",
  executable = {
    command = "node",
    args = {"/path/to/js-debug/src/dapDebugServer.js", "${port}"},
  }
}

配置说明

1. type: 设置为"server"表示这是一个服务器类型的调试适配器
2. host/port: 指定调试服务器监听的地址和端口
3. executable: 配置实际运行的调试器程序
   • command: 通常是node
   • args: 第一个参数是js-debug的入口文件路径，第二个是端口参数

路径说明

/path/to/js-debug/src/dapDebugServer.js需要替换为实际的js-debug安装路径。如果你使用mason.nvim管理调试器，路径通常是：

vim.fn.stdpath("data").."/mason/packages/js-debug-adapter/..."

调试配置示例

配置好适配器后，可以添加针对不同场景的调试配置：

-- 基本Node.js文件调试
{
  type = "pwa-node",
  request = "launch",
  name = "Debug Current File",
  program = "${file}",
  cwd = "${workspaceFolder}",
  sourceMaps = true
}

-- 附加到运行中的Node进程
{
  type = "pwa-node",
  request = "attach",
  name = "Attach to Process",
  processId = require("dap.utils").pick_process,
  cwd = "${workspaceFolder}"
}

-- Chrome调试
{
  type = "pwa-chrome",
  request = "launch",
  name = "Launch Chrome",
  url = "http://localhost:3000",
  webRoot = "${workspaceFolder}"
}

最佳实践建议

1. 保持更新: 定期更新nvim-dap和js-debug-adapter到最新版本
2. 简化配置: 避免使用不必要的中间层插件，直接配置适配器
3. 环境隔离: 为不同项目创建特定的调试配置
4. 错误处理: 添加适当的错误处理和日志记录，便于排查问题

通过以上方法，可以稳定可靠地在Neovim中实现JavaScript/TypeScript项目的调试功能，避免因API变更导致的兼容性问题。