当前位置：首页 > news >正文

Qt 调试信息重定向到本地文件

news 来源：原创 2025/4/26 7:18:37

1、在Qt软件开发过程中，我们经常使用qDebug()输出一些调试信息在QtCreator终端上。
但若将软件编译、生成、打包为一个完整的可运行的程序并安装在系统中后，系统中没有QtCreator和编译环境，那应用程序出现问题，如何输出信息排查呢?

2、一个好方法就是Qt调试信息重定向本地文件，即仍然使用qDebug()等函数，但设置后调试信息不输出在终端上，而是输出到指定路径的日志文件中，这样我们就可以通过日志进行调试。

3、Qt提供了5个全局信息输出函数，对应不同级别:
(1)、qDebug(): 调试信息。
(2)、qInfo(): 普通信息。
(3)、qWarning(): 警告信息。
(4)、qCritical(): 关键错误和系统错误信息。
(5)、qFatal(): 致命错误信息，如果运行qFatal()，应用程序会立即终止。

4、Qt调试信息重定向本地文件，只要实现消息处理函数，然后通过qInstallMessageHandler重定义，就可以将调试信息输出到指定路径的文件中了。

5、示例: (main.cpp, 其它文件略)

//main.cpp#include "widget.h"
#include <QApplication>
#include <QMutex>
#include <QDateTime>
#include <QFile>
#include <QDebug>static QMutex mutex;
void MyLog(QtMsgType type, const QMessageLogContext & context, const QString & message)
{mutex.lock();QString strType;switch (type) {case QtDebugMsg:strType = "Debug";break;case QtInfoMsg:strType = "Info";break;case QtWarningMsg:strType = "Warning";break;case QtCriticalMsg:strType = "Critical";break;default:break;}QString strFile = context.file;QString strLine = QString::number(context.line);QString strFunc = context.function;QString strTime = QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss");QString strLog = QString("[%1][%2][%3][%4][%5]%6.").arg(strType).arg(strFile).arg(strLine).arg(strFunc).arg(strTime).arg(message);QString strFileName = QString("App_%1.log").arg(QDateTime::currentDateTime().toString("yyyyMMdd"));QFile file(strFileName);file.open(QIODevice::WriteOnly | QIODevice::Append);QTextStream stream(&file);stream << strLog << "\r\n";file.flush();file.close();mutex.unlock();
}int main(int argc, char *argv[])
{QApplication a(argc, argv);qInstallMessageHandler(MyLog);qDebug() << "This is Debug";qInfo() << "This is Info";qWarning() << "This is Warning";qCritical() << "This is Critical";Widget w;w.show();return a.exec();
}

//运行结果，在exe同级目录下有一个如App_20250425.log文件，里面包含各种输出信息。

[Debug][..\..\main.cpp][57][int __cdecl main(int,char *[])][2025-04-25 16:55:49]This is Debug.
[Info][..\..\main.cpp][58][int __cdecl main(int,char *[])][2025-04-25 16:55:49]This is Info.
[Warning][..\..\main.cpp][59][int __cdecl main(int,char *[])][2025-04-25 16:55:49]This is Warning.
[Critical][..\..\main.cpp][60][int __cdecl main(int,char *[])][2025-04-25 16:55:49]This is Critical.
[Debug][..\..\main.cpp][57][int __cdecl main(int,char *[])][2025-04-25 16:56:51]This is Debug.
[Info][..\..\main.cpp][58][int __cdecl main(int,char *[])][2025-04-25 16:56:51]This is Info.
[Warning][..\..\main.cpp][59][int __cdecl main(int,char *[])][2025-04-25 16:56:51]This is Warning.
[Critical][..\..\main.cpp][60][int __cdecl main(int,char *[])][2025-04-25 16:56:51]This is Critical.