Qt C++调试之如何生成dump文件（收藏）

，01

演示：

Qt5.12.9

VS2022

02

# 🔧 Qt C++ 软件调试完全指南

## 📖 简介

Qt C++ 软件调试是一项核心技能，无论是开发阶段的问题排查，还是发布后的崩溃分析，都需要系统性的调试方法。本指南从多个维度带你掌握 Qt 调试技术。

---

## 🎯 调试体系概览

### 🔍 调试层次分类

```

┌─────────────────┐

│ 应用层调试 │ ← 逻辑错误、业务逻辑

├─────────────────┤

│ 系统层调试 │ ← 内存泄漏、资源管理

├─────────────────┤

│ 崩溃分析调试 │ ← 异常捕获、转储分析

└─────────────────┘

```

---

## 🛠️ 核心调试技术

### 1️⃣ **编译时调试准备**

- ✅ **调试符号生成**：通过 PDB 文件保留调试信息

- ✅ **断言机制**：使用 `Q_ASSERT()` 和 `Q_CHECK_PTR()`

- ✅ **编译警告**：启用所有编译器警告选项

```cpp

// 项目配置示例

CONFIG += force_debug_info # 生成调试符号

```

```

#=================================Qt生成PDB文件的方法============================================

#-Od：去掉编译器优化；

#-ZI：控制生成pdb调试文件；

#-MD：使用多线程库

# 方法1

#QMAKE_CXXFLAGS_RELEASE = -Od -ZI -MD

#QMAKE_LFLAGS_RELEASE = /DEBUG /INCREMENTAL:NO

# 方法2

CONFIG += force_debug_info

QMAKE_CXXFLAGS_RELEASE_WITH_DEBUGINFO += -Od

```

### 2️⃣ **运行时调试工具**

#### 🔧 Qt Creator 调试器

-**断点调试**：条件断点、数据断点、内存断点

-**变量监视**：实时查看变量值和内存状态

-**调用栈分析**：追溯函数调用链路

-**内存视图**：检查内存布局和内容

#### 📊 日志系统

```cpp

// Qt 日志分级

qDebug() << "调试信息：" << variable;

qInfo() << "一般信息：" << status;

qWarning() << "警告信息：" << warning;

qCritical() << "严重错误：" << error;

```

### 3️⃣ **内存调试技术**

#### 🔍 内存泄漏检测

```cpp

// Qt 内存调试宏

#define QT_NO_DEBUG_OUTPUT // 关闭调试输出

#define QT_MESSAGELOGCONTEXT // 显示日志上下文

```

#### 💾 堆栈分析

-**Valgrind**（Linux）：内存错误检测

-**Visual Studio Diagnostics**：Windows 内存分析

-**Application Verifier**：Windows 应用验证工具

### 4️⃣ **崩溃分析与处理**

#### 💥 异常捕获机制

```cpp

// Windows 异常处理

LONG WINAPI CrashHandler(EXCEPTION_POINTERS* pExceptionInfo) {

// 生成转储文件

MiniDumpWriteDump(/* 参数 */);

return EXCEPTION_EXECUTE_HANDLER;

}

// Qt 信号槽异常连接

QObject::connect(sender, &Sender::error,

[](constQString&error) {

qCritical() << "槽函数错误：" << error;

});

```

#### 📁 转储文件分析

-**WinDbg**：Windows 调试器，分析 .dmp 文件

-**Visual Studio**：直接打开转储文件调试

-**cdb.exe**：命令行调试工具

下载：[https://learn.microsoft.com/en-us/sysinternals/downloads/procdump](url)

---

## 🎨 Qt 特有调试技巧

### 🖼️ **UI 调试**

### 🌐 **网络调试**

```cpp

// 网络请求调试

QNetworkRequest::Attribute attr = QNetworkRequest::HttpStatusCodeAttribute;

int statusCode = reply->attribute(attr).toInt();

// SSL 调试

QSslConfiguration sslConfig = QSslConfiguration::defaultConfiguration();

```

### 📡 **信号槽调试**

```cpp

// 信号连接状态调试

QMetaObject::Connection conn = QObject::connect(/* 参数 */);

if (!conn) {

qDebug() << "信号连接失败";

}

// 使用 QObject::dumpObjectInfo() 查看连接信息

```

---

## 📱 跨平台调试策略

### 🖥️ **Windows 平台**

-**Visual Studio 集成调试**

-**WinDbg 深度分析**

-**Event Viewer 系统日志**

### 🐧 **Linux 平台**

-**GDB 命令行调试**

-**Valgrind 内存检查**

-**strace 系统调用跟踪**

### 🍎 **macOS 平台**

-**Xcode 调试器**

-**Instruments 性能分析**

-**Console 应用日志**

---

## 🚀 高级调试技术

### 🔎 **远程调试**

```cpp

// 远程调试配置

// 在 Qt Creator 中设置远程设备

// 使用 GDB Server 或 LLDB Server

```

### 📊 **性能分析**

```cpp

// QElapsedTimer 性能计时

QElapsedTimer timer;

timer.start();

// ... 执行代码

qDebug() << "执行时间：" << timer.elapsed() << "毫秒";

```

### 🔄 **多线程调试**

```cpp

// 线程调试

QThread* currentThread = QThread::currentThread();

qDebug() << "当前线程ID：" << currentThread->currentThreadId();

// 线程安全检查

QMutexLockerlocker(&mutex);

```

---

## 🛡️ 调试最佳实践

### ✅ **开发阶段**

1.**增量调试**：小步快跑，及时验证

2.**单元测试**：确保模块功能正确

3.**代码审查**：预防潜在问题

### ✅ **测试阶段**

1.**边界测试**：测试极端情况

2.**压力测试**：验证稳定性

3.**兼容性测试**：多环境验证

### ✅ **发布阶段**

1.**日志收集**：用户反馈信息

2.**崩溃监控**：实时异常捕获

3.**版本回滚**：快速问题修复

---

## 🎯 调试思维培养

### 🤔 **问题分析方法**

```

现象描述 → 环境确认 → 复现步骤 →

根因分析 → 解决方案 → 验证测试 →

文档记录 → 预防措施

```

### 📝 **调试日志规范**

-**时间戳**：精确到毫秒

-**上下文**：函数名、行号、变量值

-**级别标识**：错误、警告、信息、调试

-**用户信息**：操作步骤、环境描述

---

## 📚 总结

Qt C++ 调试是一个系统工程，需要：

1.**扎实的基础**：理解 Qt 框架和 C++ 语言特性

2.**丰富的工具**：熟练使用各类调试工具

3.**系统的思维**：建立完整的问题分析流程

4.**持续的学习**：跟进新技术和方法

**记住**：调试不仅是找 bug，更是提升代码质量和开发效率的重要手段！

---

*🔚 持续学习，持续进步，让调试成为你的核心竞争力！*

03

关键配置Pro

QT       += core guigreaterThan(QT_MAJOR_VERSION, 4): QT += widgetsCONFIG += c++11CONFIG += resources_big# 在release模式下生成调试信息(PDB文件)CONFIG += force_debug_info# The following define makes your compiler emit warnings if you use# any Qt feature that has been marked deprecated (the exact warnings# depend on your compiler). Please consult the documentation of the# deprecated API in order to know how to port your code away from it.DEFINES += QT_DEPRECATED_WARNINGS# You can also make your code fail to compile if it uses deprecated APIs.# In order to do so, uncomment the following line.# You can also select to disable deprecated APIs only up to a certain version of Qt.#DEFINES += QT_DISABLE_DEPRECATED_BEFORE=0x060000    # disables all the APIs deprecated before Qt 6.0.0SOURCES += \    main.cpp \    dialog.cppHEADERS += \    dialog.hFORMS += \    dialog.ui# Default rules for deployment.qnx: target.path = /tmp/$${TARGET}/binelse: unix:!android: target.path = /opt/$${TARGET}/bin!isEmpty(target.path): INSTALLS += target# 可执行文件路径CONFIG(debug, debug|release){    contains(DEFINES, WIN64) {        DESTDIR = $$PWD/x64/debug    } else {        DESTDIR = $$PWD/x86/debug    }} else {    contains(DEFINES, WIN64) {        DESTDIR = $$PWD/x64/release    } else {        DESTDIR = $$PWD/x86/release    }}#解决中文乱码contains( CONFIG, "msvc" ): QMAKE_CXXFLAGS +=  /source-charset:utf-8 /execution-charset:utf-8contains( CONFIG, "msvc" ): QMAKE_CFLAGS +=  /source-charset:utf-8 /execution-charset:utf-8#忽略代码页警告contains( CONFIG, "msvc" ): QMAKE_CXXFLAGS += /wd4819 /wd4828#==============================================调试定位==============================================# 使用Qt官方推荐方法：force_debug_info 会在release模式下自动生成PDB文件# 该配置会自动设置 QMAKE_*_RELEASE_WITH_DEBUGINFO 相关变量# 注意：需要Qt 5.13.2或更高版本支持

04

windows 生成dump接口实现

#include "dialog.h"#include <QApplication>#include <qt_windows.h>// D:\Program Files (x86)\Windows Kits\10\Include\10.0.26100.0\um#include <DbgHelp.h>#pragma comment(lib,"Dbghelp.lib")/** * 异常回调函数，用于生成崩溃转储文件 * @param pexcp 异常信息指针 * @return 异常处理返回值 */long  __stdcall CrashInfocallback(_EXCEPTION_POINTERS *pexcp){    // 获取当前时间并格式化为文件名    SYSTEMTIME st;    GetLocalTime(&st);    // 创建带时间戳的DUMP文件名    wchar_t dumpFileName[MAX_PATH];    swprintf_s(dumpFileName, MAX_PATH, L"crash_%04d%02d%02d_%02d%02d%02d.dmp",               st.wYear, st.wMonth, st.wDay, st.wHour, st.wMinute, st.wSecond);    // 创建 Dump 文件    HANDLE hDumpFile = ::CreateFile(                dumpFileName,                GENERIC_WRITE,                0,                NULL,                CREATE_ALWAYS,                FILE_ATTRIBUTE_NORMAL,                NULL                );    if (hDumpFile != INVALID_HANDLE_VALUE)    {        // Dump信息结构体        MINIDUMP_EXCEPTION_INFORMATION dumpInfo;        dumpInfo.ExceptionPointers = pexcp;        dumpInfo.ThreadId = GetCurrentThreadId();        dumpInfo.ClientPointers = TRUE;        // 写入Dump文件内容        ::MiniDumpWriteDump(                    GetCurrentProcess(),                    GetCurrentProcessId(),                    hDumpFile,                    MiniDumpNormal,                    &dumpInfo,                    NULL,                    NULL                    );        // 关闭文件句柄        CloseHandle(hDumpFile);    }    return 0;}int main(int argc, char *argv[]){    QApplication a(argc, argv);    // 实时检测异常Bug在崩溃时生成Dump文件    ::SetUnhandledExceptionFilter((LPTOP_LEVEL_EXCEPTION_FILTER)CrashInfocallback);    Dialog w;    w.show();    return a.exec();}

05

演示：

点击按钮位置，当程序崩溃，会生成dump文件

点击右键使用vs2022打开。设置符号路径

所谓的符号就是设置Qt_DbgHelp.pdb的路径目录，等下会自动定位代码报错的位置。

然后点击本机调试，就会自动定位带源文件代码位置。

06

获取Demo测试

通过网盘分享的文件：Qt dump调试

链接: https://pan.baidu.com/s/16i8AKLKyprILff6fpVwJzA?pwd=ejpi 提取码: ejpi

❤❤❤