使用msvc2017-32bit套件构建Qt项目无法单步进入Qt源码怎么办

问题诱因 #

该报错Stopped: "end-stepping-range"本质是调试器无法找到待步进的Qt函数对应的调试符号与源码文件，只能在执行完函数后停下，常见触发原因如下：

• 安装Qt时未勾选对应msvc2017-32bit版本的调试库与Qt源码组件，预编译的Release版Qt库默认不带调试符号与源码映射
• 项目使用Release模式构建，编译器开启的优化规则会内联函数调用、重排代码结构，导致调试器无法匹配代码行
• 调试器未正确加载Qt调试库对应的pdb符号文件，或本地Qt源码路径与Qt官方预编译时的源码路径不匹配
• Qt Creator默认开启了「跳过无源码函数」的调试规则，主动拦截了对Qt函数的步进操作

解决方案 #

按以下步骤逐一排查即可：

• 打开Qt Maintenance Tool，在对应msvc2017-32bit版本的组件列表中，确认已安装「Debug 调试库」和「Qt 源码」两个组件，缺失则补装
• 切换项目构建模式为Debug，确认构建设置中无额外的编译器优化参数（如O2、Ob1类优化标识），构建套件完全匹配msvc2017-32bit
• 进入Qt Creator调试视图的「模块」面板，确认你用到的Qt模块（如Qt5Cored.dll、Qt5Widgetsd.dll等）对应的pdb文件已被正常加载，未加载则手动指定pdb文件路径，默认路径为Qt安装目录下msvc2017_32\bin文件夹
• 配置源码路径映射：在Qt Creator「工具-选项-调试器-通用设置」中添加路径映射规则，源路径填Qt预编译时的原始路径（对应msvc2017-32bit的预编译包原始路径一般为/work/build/qt5），目标路径填你本地Qt源码的实际存放路径
• 关闭Qt Creator调试器的自动跳过规则：在「工具-选项-调试器-通用设置」中取消勾选「跳过没有源码的函数」选项，重启调试即可

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