CodeLLDB调试失败需依次检查LLDB路径配置、launch.json有效性、启用日志定位错误、重装扩展并清除缓存、必要时降级至v1.10.2稳定版。
如果您在VSCode中使用LLDB进行本地C/C++或Rust程序调试，但发现调试会话无法启动、断点不命中或变量值无法查看，则可能是由于CodeLLDB扩展未正确配置或与当前调试环境不兼容。以下是解决此问题的步骤：
本文运行环境：MacBook Pro，macOS Sequoia。
一、验证LLDB二进制路径配置
CodeLLDB依赖系统或自定义安装的LLDB命令行工具，若扩展无法定位到可用的lldb可执行文件，调试器将无法初始化。需手动指定其路径以确保扩展调用正确的后端。
1、打开VSCode设置（快捷键 Cmd + ,）。
2、在搜索框中输入 codelldb.lldbExecutable。
3、点击“编辑在 settings.json”链接，在右侧用户设置JSON中添加键值对："codeLLDB.lldbExecutable": "/usr/bin/lldb"（macOS系统默认路径）或指向Homebrew安装的路径如 "/opt/homebrew/bin/lldb"。
4、保存文件并重启VSCode窗口。
二、检查调试配置launch.json有效性
launch.json中的配置项直接影响CodeLLDB能否正确加载目标二进制、符号文件及运行时参数。缺失miDebuggerPath或错误的program路径会导致调试器静默失败。
1、在项目根目录下打开 .vscode/launch.json 文件。
2、确认配置中包含 "type": "lldb" 且 "request": "launch"。
3、检查 "program" 字段是否为绝对路径，例如 "${workspaceFolder}/build/myapp"，而非相对路径或未构建的源文件。
4、如使用自定义LLDB前端（如llvm-mi），添加 "miDebuggerPath": "/opt/homebrew/opt/llvm/bin/lldb-mi"（需提前通过Homebrew安装llvm）。
三、启用调试日志定位初始化错误
CodeLLDB提供详细日志输出功能，可暴露插件加载、LLDB实例启动、DAP协议通信等环节的底层错误，是诊断连接失败或崩溃问题的关键手段。
1、在VSCode命令面板（Shift + Cmd + P）中输入并选择 LLDB: Toggle Log。
2、启动一次调试会话，等待失败后立即停止。
3、打开VSCode输出面板（Cmd + Shift + U），在下拉菜单中选择 LLDB。
4、查找包含 "error" 或 "failed" 的行，重点关注 "Failed to launch debug adapter" 或 "Unable to find lldb-dap binary" 类提示。
四、重装扩展并清除插件缓存
VSCode扩展更新可能残留旧版资源或损坏的DAP二进制文件，导致调试适配器无法注册或响应请求。彻底卸载并清理相关缓存可恢复扩展原始状态。
1、在扩展视图（Cmd + Shift + X）中搜索 CodeLLDB，点击卸载按钮。
2、关闭VSCode应用进程（包括Dock中仍在运行的图标）。
3、在终端中执行：rm -rf ~/.vscode/extensions/vadimcn.vscode-lldb-*。
4、重新打开VSCode，从扩展市场安装最新稳定版CodeLLDB。
五、降级至已知稳定版本
部分新发布的CodeLLDB版本存在与特定LLDB主干版本或macOS系统调用的兼容性问题，例如对libstdc++符号解析异常或M1/M2芯片上寄存器读取失败。切换至经广泛验证的旧版可绕过此类缺陷。
1、在扩展详情页点击右上角“…”，选择 Install Another Version...。
2、从列表中选择 v1.10.2（该版本已确认兼容Xcode Command Line Tools 15.3及LLDB 18.1.7）。
3、安装完成后，不重启VSCode，直接运行 Developer: Reload Window 命令。
