Qt日志功能（qDebug、qWarnng、qCritical、qFatal）

最新推荐文章于 2025-06-04 08:15:00 发布

Embedded engineer

最新推荐文章于 2025-06-04 08:15:00 发布

阅读量3.3k

点赞数 2

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/eastcnme/article/details/103090641

本文介绍Qt中使用qDebug等函数输出不同级别的日志，并通过qInstallMessageHandler自定义消息处理器，将日志信息写入文件。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、基本分类：
qDebug : 调试信息提示
qWarning: 一般的警告提示
qCritical: 严重错误提示
qFatal: 致命错误提示

二、如何截获这些信息
Qt提供了qInstallMsgHandler 方法用来定制消息发生后如何来处理。
qInstallMsgHandler 是一个回调函数，主要是由qDebug、qWarnng、qCritical、qFatal这些函数进行触发，
也就是说，qDeubg这些函数处理的消息文本会被qInstallMsgHandler 所指向的回调函数截获，这样就允许用户自己来处理这些消息文本。
例如，你完全可以将这些消息文本输出并保存到相关的日志文件中。请看下面的示例！

三、将qDebug()\qWarning()\qCritical()\qFatal() 信息输出到指定文件中

点击(此处)折叠或打开

#include <QtDebug>
#include <QFile>
#include <QTextStream>
void customMessageHandler(QtMsgType type, const char *msg)
{
QString txt;
switch (type) {
//调试信息提示
case QtDebugMsg:
txt = QString("Debug: %1").arg(msg);
break;
//一般的warning提示
case QtWarningMsg:
txt = QString("Warning: %1").arg(msg);
break;
//严重错误提示
case QtCriticalMsg:
txt = QString("Critical: %1").arg(msg);
break;
//致命错误提示
case QtFatalMsg:
txt = QString("Fatal: %1").arg(msg);
abort();
}
QFile outFile("debuglog.txt");
outFile.open(QIODevice::WriteOnly | QIODevice::Append);
QTextStream ts(&outFile);
ts << txt << endl;
}
int main( int argc, char * argv[] )
{
QApplication app( argc, argv );
//先注册自己的MsgHandler
qInstallMsgHandler(customMessageHandler);
//以后就可以像下面这样直接打日志到文件中，而且日志也会包含时间信息
qDebug("This is a debug message at thisisqt.com");
qWarning("This is a warning message at thisisqt.com");
qCritical("This is a critical message at thisisqt.com");
qFatal("This is a fatal message at thisisqt.com");
return app.exec();
}

四、如何取消信息处理呢？
简单：
还是用qInstallMsgHandler.
只要执行qInstallMsgHandler(0) 就可以了

#########################################################################
在Qt开发过程当中经常使用qDebug等一些输出来调试程序，但是到了正式发布的时候，都会被注释或者删除，采用日志输出来代替。
做过项目的童鞋可能都使用过日志功能，以便有异常错误能够快速跟踪、定位，Qt也提供的类似的机制。之前用Qt4做项目时使用的是Qt::qInstallMsgHandler()，到了Qt5，使用了新的Qt::qInstallMessageHandler()来替代，详情请查看Qt助手（C++ API changes）。

描述
助手中在C++ API changes中提到：Qt::qDebug()、Qt::qWarning()、Qt::qCritical()、Qt::qFatal()被改变为宏来跟踪源代码的消息来源。被打印的信息可以被配置（用于缺省消息处理程序），通过设置该新的环境变量QT_MESSAGE_PATTERN。Qt::qInstallMsgHandler()已过时，因此建议使用Qt::qInstallMessageHandler()来代替。

级别
qDebug：调试信息
qWarning：警告信息
qCritical：严重错误
qFatal：致命错误

实例

需求（目的）：
生成log.txt日志文件，记录详细日志信息（包括等级、描述信息、产生时间等）,以便于快速跟踪、定位。

点击(此处)折叠或打开

void outputMessage(QtMsgType type, const QMessageLogContext &context, const QString &msg)
{
QString text;
switch(type)
{
case QtDebugMsg:
text = QString("Debug:");
break;
case QtWarningMsg:
text = QString("Warning:");
break;
case QtCriticalMsg:
text = QString("Critical:");
break;
case QtFatalMsg:
text = QString("Fatal:");
}
QDateTime current_date_time = QDateTime::currentDateTime();
QString current_date = current_date_time.toString("yyyy-MM-dd hh:mm:ss ddd");
QString message = text.append(msg).append("(").append(current_date).append(")");
QFile file("log.txt");
file.open(QIODevice::WriteOnly | QIODevice::Append);
QTextStream text_stream(&file);
text_stream<<message<<"\r\n";
file.close();
}
int main(int argc, char *argv[])
{
QApplication app(argc, argv);
//注册MessageHandler
qInstallMessageHandler(outputMessage);
//打印日志到文件中
qDebug("This is a debug message");
qWarning("This is a warning message");
qCritical("This is a critical message");
qFatal("This is a fatal message");
return app.exec();
}