VS Code中C++/CMake项目调试信息丢失、断点无效问题求助

1. 确保CMake生成带调试符号的Debug构建 #

调试无法工作的核心原因通常是可执行文件未包含调试符号，默认CMake若用Release模式构建会省略这些信息。

修改你的CMakeLists.txt，添加Debug构建类型配置：

# 强制默认构建类型为Debug（未指定时）
if(NOT CMAKE_BUILD_TYPE AND NOT CMAKE_CONFIGURATION_TYPES)
  set(CMAKE_BUILD_TYPE Debug CACHE STRING "Build type" FORCE)
  set_property(CACHE CMAKE_BUILD_TYPE PROPERTY STRINGS "Debug" "Release" "RelWithDebInfo")
endif()

# 原项目配置
cmake_minimum_required(VERSION 3.1)

project(test_project VERSION 1.0
                  DESCRIPTION "testing cmake"
                  LANGUAGES CXX)

add_library(announcable STATIC Libs/announcable.cpp Libs/announcable.h)
add_library(announcer STATIC Libs/announcer.cpp Libs/announcer.h)
target_include_directories(announcable PUBLIC include)
target_include_directories(announcer PUBLIC include)

add_executable(app main.cpp)
target_link_libraries(app PUBLIC announcable announcer)

也可在构建时通过命令行明确指定：

cmake -DCMAKE_BUILD_TYPE=Debug ..
make

2. 修正VS Code的launch.json配置 #

你的launch.json存在两处可能影响调试的问题：

• 包含了GDB专属配置命令，LLDB不兼容
• externalConsole: true在M1 Mac上可能导致调试器无法附加到进程

修改后的launch.json：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "(LLDB) Launch",
            "type": "lldb",
            "request": "launch",
            "program": "${command:cmake.launchTargetPath}",
            "args": [],
            "stopAtEntry": true, // 设为true可验证调试器是否能在启动时暂停
            "cwd": "${workspaceFolder}",
            "environment": [
                {
                    "name": "PATH",
                    "value": "$PATH:${command:cmake.launchTargetDirectory}"
                }
            ],
            "externalConsole": false, // 使用VS Code内置终端
            "setupCommands": [
                {
                    "description": "Enable LLDB C++ pretty-printing",
                    "text": "command script import lldb.macosx.cxx",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

3. 验证VS Code插件与构建配置 #

• 确保安装了CMake Tools和CodeLLDB插件（CodeLLDB对M1 arm64架构支持更稳定）
• 在VS Code底部状态栏，点击CMake Tools显示的构建类型（如"Release"），切换为"Debug"
• 清理旧构建：删除项目下的build文件夹，重新运行CMake生成构建文件并重新编译

4. 手动验证调试符号 #

若以上步骤无效，用命令行验证可执行文件是否包含调试符号：

cd build
# 检查可执行文件信息
file app

输出中应包含DEBUG_INFO字样，例如：
Mach-O 64-bit executable arm64, flags:<NOUNDEFS|DYLDLINK|TWOLEVEL|PIE|DEBUG_INFO>

也可用LLDB手动调试确认：

lldb ./app
# 在main.cpp第8行设置断点
breakpoint set --file main.cpp --line 8
# 启动程序
run

如果手动调试能触发断点，说明问题出在VS Code配置；若仍无法触发，需检查CMake编译选项是否正确生成调试符号。

内容的提问来源于stack exchange，提问作者Amelia Haghighi