VSCode调试C++：如何单步进入编译库仅停在指定源码目录？

1. 构建库时保留原始源码路径 #

给库做CMake构建时，确保调试信息里的源码路径指向$HOME/mylibrary，而非安装路径：

• 用Debug模式构建：

  cmake -S $HOME/mylibrary -B $HOME/mylibrary/build -DCMAKE_BUILD_TYPE=Debug
  cmake --build $HOME/mylibrary/build
  

• 在库的CMakeLists.txt里添加以下配置，防止安装时重写源码路径：

  set(CMAKE_BUILD_WITH_INSTALL_RPATH OFF)
  set(CMAKE_INSTALL_RPATH_USE_LINK_PATH OFF)
  

2. 调试器中替换源码路径 #

用gdb调试时，把调试信息里指向安装目录的源码路径替换成原库的源码目录：

• 启动gdb后执行：

  set substitute-path $HOME/.local/include $HOME/mylibrary/include
  set substitute-path $HOME/.local/src $HOME/mylibrary/src
  

  替换路径根据你实际安装的库的源码文件位置调整，确保所有安装目录下的源码路径都被映射到原库目录。

3. 让项目优先加载构建目录的库 #

运行调试项目前，设置环境变量让系统优先加载$HOME/mylibrary/build下的库（而非$HOME/.local的安装版）：

export LD_LIBRARY_PATH=$HOME/mylibrary/build:$LD_LIBRARY_PATH

构建目录的库带有原始源码路径的调试信息，调试时自然只会进入$HOME/mylibrary的源码。

4. 可选：安装不带调试信息的库 #

如果不需要安装版的库带调试信息，安装时用Release模式构建：

cmake --build $HOME/mylibrary/build --target install -DCMAKE_BUILD_TYPE=Release

这样$HOME/.local下的库没有调试信息，调试器只会识别构建目录里带完整调试信息的库，不会跳转到安装目录的源码。

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