解决nvim-dap与lldb-dap调试中的"Source not available"问题

问题背景

在使用nvim-dap插件配合lldb-dap调试器进行C/C++程序调试时，部分用户遇到了"Source not available, cannot jump to frame"的错误提示。这个问题主要出现在Mac M1和ARM架构设备上，使用LLVM 18.x版本的lldb-dap时较为常见。

问题表现

当开发者配置好调试环境后，会出现以下现象：

1. 程序启动时虽然设置了stopOnEntry为true，但无法正确显示源代码位置
2. 设置的断点不会被命中
3. 调试器输出的堆栈帧信息中缺少有效的源代码路径

根本原因分析

经过社区调查和测试，这个问题主要与LLVM 18.x版本的lldb-dap实现有关。调试适配器返回的堆栈帧信息中缺少有效的source字段，导致客户端无法定位和显示源代码。具体表现为：

• 堆栈帧信息中的source字段缺失或为空
• 行号信息(line)为0
• 部分情况下函数名显示为内部符号而非用户定义的函数名

解决方案

临时解决方案

目前最可靠的解决方法是降级到LLVM 17.x版本：

1. 卸载当前LLVM 18.x版本
2. 安装LLVM 17.x版本
3. 确保lldb-dap或lldb-vscode可执行文件在PATH中

替代方案

如果无法降级LLVM版本，可以考虑以下替代方案：

1. 使用codelldb作为替代调试适配器
2. 使用gdb作为替代调试器（在支持的环境中）
3. 检查并确保编译时已生成完整的调试符号（-g标志）

配置建议

以下是一个经过验证的基本配置示例，适用于大多数C/C++项目：

dap.adapters.lldb = {
    type = "executable",
    command = "/path/to/lldb-dap",
    name = "lldb-dap",
}

dap.configurations.c = {
    {
        name = "Debug",
        type = "lldb",
        request = "launch",
        program = function()
            return vim.fn.input("Path to executable: ", vim.fn.getcwd() .. "/", "file")
        end,
        cwd = "${workspaceFolder}",
        stopOnEntry = false,
        args = {},
    },
}
dap.configurations.cpp = dap.configurations.c

注意事项

1. 确保编译时使用了正确的调试标志（如CMake中的-DCMAKE_BUILD_TYPE=Debug）
2. 验证生成的二进制文件确实包含调试信息（可使用file命令检查）
3. 不同平台可能需要调整路径和配置细节
4. 如果使用Homebrew安装，注意版本管理可能导致的问题

未来展望

这个问题本质上是LLVM 18.x版本中lldb-dap的实现问题，建议关注LLVM项目的更新，等待后续版本修复。同时，nvim-dap社区也会持续关注相关进展，及时更新文档和推荐配置。

对于开发者而言，在问题修复前，使用经过验证的稳定版本（LLVM 17.x）是最可靠的选择。随着调试器生态的不断发展，相信这类兼容性问题将逐步得到解决。