在Qt Creator的CMake项目中调试OpenCV内部函数的问题

• 检查OpenCV编译的调试信息完整性

  • 确认CMake配置时，除了-DCMAKE_BUILD_TYPE=Debug和-DBUILD_WITH_DEBUG_INFO=ON，需添加-DBUILD_SHARED_LIBS=ON（动态库场景）；若用静态库，确保编译过程未剥离调试符号。
  • 编译完成后，验证库文件的调试符号：Linux下执行objdump --syms libopencv_imgproc.so | grep Subdiv2D，Windows下执行dumpbin /SYMBOLS opencv_imgprocd.dll，确认输出中存在Subdiv2D::insert的符号记录。

• 验证Qt Creator项目的调试配置

  • 打开项目面板的构建&运行页面，确认当前构建套件的构建类型为Debug，排除Release/RelWithDebInfo模式。
  • 检查调试器配置：确保使用的调试器（GDB/LLDB/CDB）与编译OpenCV的编译器版本匹配（如GCC编译对应GDB，Clang编译对应LLDB）。
  • 核对项目CMakeLists.txt：确认链接的是OpenCV的Debug版本库（Windows下为带d后缀的库，如opencv_imgproc4xxd.lib；Linux下为Debug安装目录下的库文件），避免误链Release版本。

• 调整调试器的跳过规则

  • 进入Qt Creator的工具->选项->调试器->GDB/LLDB面板，查看跳过的函数或自动跳过的符号列表，若存在cv::*或Subdiv2D::insert这类规则，直接删除。
  • 调试时，先在调用Subdiv2D::insert()的代码行手动添加断点，运行至断点后使用步进进入（F7）而非步进越过（F10），强制触发进入函数内部的逻辑。

• 修正源码路径映射

  • 若调试时弹出“找不到源码文件”提示，在调试器的源码查找路径中添加下载的OpenCV源码根目录，确保opencv/modules/imgproc/src/subdiv2d.cpp这类文件能被正确定位。
  • 确认OpenCV的imgproc模块已完整编译：检查CMake配置输出，确保BUILD_opencv_imgproc被设为ON。

• 清理缓存并重新构建

  • 删除Qt Creator项目的构建目录，重新运行CMake配置，确保项目依赖完全链接到Debug版本的OpenCV库。
  • 重新构建OpenCV：执行ninja clean清理旧构建产物，再运行ninja install，避免旧Release版本库残留干扰。

内容的提问来源于stack exchange，提问作者Paweł Kłeczek