解决nvim-dap与Delve调试Go程序时"stub exited"错误

在Neovim中使用nvim-dap插件配合Delve调试Go程序时，开发者可能会遇到"stub exited while waiting for connection"的错误提示。这个问题通常与环境配置有关，特别是当开发环境存在架构不匹配的情况时。

问题现象

当尝试通过nvim-dap启动Go程序调试会话时，虽然Delve服务进程确实启动了，但调试器无法正确附加到目标程序。错误信息表现为：

Error on launch: Failed to launch: could not launch process: stub exited while waiting for connection: exit status 0

根本原因分析

这个问题通常由以下几个因素导致：

1. 路径问题：Delve可能要求程序路径必须是绝对路径，而相对路径可能导致启动失败。

2. 架构不匹配：在Apple Silicon(M1/M2)设备上，如果使用Intel版本的Homebrew安装的工具链，会导致架构不兼容。

3. Delve特殊要求：在macOS上，Delve有特殊的安装要求，特别是关于代码签名的部分。

解决方案

1. 确保使用绝对路径

修改nvim-dap配置，确保program参数使用绝对路径：

dap.configurations.go = {
    {
        type = "delve",
        name = "Debug",
        request = "launch",
        program = vim.fn.expand("${file}"),  -- 确保转换为绝对路径
    },
}

2. 检查并修复架构兼容性问题

对于Apple Silicon设备用户：

1. 确认Homebrew版本架构：

   • 运行brew config检查架构
   • 如果显示CPU: x86_64，说明是Intel版本

2. 迁移到原生ARM版本：

   • 备份现有Homebrew配置
   • 按照官方指南迁移到ARM版本
   • 重新安装所有开发工具链

3. 重新安装Neovim及其依赖：

   • 确保所有工具都是为ARM架构编译的

3. 遵循Delve的特殊安装要求

在macOS上，Delve需要特殊的代码签名配置：

1. 创建自签名证书：

   • 使用钥匙串访问工具创建代码签名证书
   • 确保证书设置为"始终信任"

2. 重新安装Delve：

   • 使用正确签名的版本
   • 确保安装过程没有警告或错误

4. 验证环境配置

完成上述步骤后，进行以下验证：

1. 直接在终端运行dlv debug命令，确认可以正常调试
2. 检查go env输出，确认环境变量设置正确
3. 确保Go项目和所有依赖都在正确的位置

高级调试技巧

如果问题仍然存在，可以尝试以下方法：

1. 启用Delve的详细日志：

   executable = {
       command = "dlv",
       args = { "dap", "-l", "127.0.0.1:8086", "--log", "--log-output=dap" },
   },
   

2. 检查Neovim日志：

   • 使用:messages命令查看错误详情
   • 检查nvim-dap的日志输出

3. 尝试最小化配置：

   • 创建一个最简单的Go程序进行测试
   • 使用最基础的nvim-dap配置排除其他干扰因素

总结

"stub exited"错误通常反映了底层调试器与目标程序之间的连接问题。通过确保环境架构一致、路径配置正确以及遵循Delve的特殊要求，大多数情况下可以解决这个问题。对于Apple Silicon用户，特别注意工具链的架构兼容性是关键所在。

记住，调试工具链的配置有时需要耐心和细致的检查，但一旦正确设置，nvim-dap与Delve的组合将提供强大的Go语言调试体验。