【Qt 应用开发】Qt 中的信息输出机制：QDebug、QInfo、QWarning、QCritical 的简单介绍和用法

Qt 中的信息输出机制
介绍
QDebug
在 Qt 中使用 qDebug
输出不同类型的信息
浮点数：使用 %!f(MISSING) 格式化符号输出浮点数
布尔值：使用 %! (MISSING)和 %! (MISSING)格式化符号输出布尔值
对象：使用 qPrintable() 函数输出对象的信息
qInfo
qWarning
qCritical
自定义信息输出格式
不同输出方式的区别和底层逻辑
进一步探讨
改变重定向方式
1. 定义自定义消息处理器
2. 安装消息处理器
3. 实现重定向逻辑
注意事项
总结
结语

介绍
在 Qt 中，信息输出机制用于在程序运行时输出各种信息，包括调试信息、提示信息、警告信息和错误信息等。Qt 提供了多种信息输出机制，主要包括以下几种：

qDebug：最常用的信息输出机制，用于输出各种调试信息，例如变量的值、函数的返回值和对象的状态等。可以通过在代码中添加 qDebug() 语句来输出信息。
qInfo：用于输出提示信息，例如程序启动信息和操作成功信息等。可以通过在代码中添加 qInfo() 语句来输出信息。
qWarning：用于输出警告信息，例如一些异常但不致命的错误信息。可以通过在代码中添加 qWarning() 语句来输出信息。
qCritical：用于输出错误信息，例如一些致命的错误信息。可以通过在代码中添加 qCritical() 语句来输出信息。
每种信息输出机制都有不同的作用和使用场景，可以根据需要进行选择。例如，在调试过程中，可以使用 qDebug 输出各种调试信息，以便快速定位和解决问题。而在生产环境中，可以使用 qInfo 输出一些重要的提示信息，以便用户了解程序的运行状况。
需要注意的是，信息输出机制可能会对程序的性能产生影响，因此在使用时需要慎重考虑。可以通过在编译时添加宏定义的方式来控制信息输出，例如通过定义 QT_NO_DEBUG 宏来禁用 qDebug 输出。

QDebug
在 Qt 中，使用 qDebug 输出调试信息是一种常用的调试方法，可以在程序运行时输出各种调试信息，例如变量的值、函数的返回值和对象的状态等。下面介绍如何在 Qt 中使用 qDebug 输出调试信息，并输出不同类型的信息。

在 Qt 中使用 qDebug
使用 qDebug 输出调试信息非常简单，只需要在代码中添加 qDebug() 语句，即可在程序运行时输出信息。例如，下面的代码输出了一个字符串和一个整数的值：

QString str = "Hello, world!";
int num = 123;
qDebug() << str << num;
1
2
3
在程序运行时，会输出如下信息：
Hello, world!" 123
需要注意的是，qDebug 输出的信息会自动换行，并以空格分隔不同的参数。如果需要输出多行信息，可以在每行末尾添加 << '\n'，例如：

qDebug() << "Line 1" << '\n'
       << "Line 2" << '\n';
1
2
输出不同类型的信息
除了字符串和整数外，qDebug 还可以输出其他类型的信息，例如浮点数、布尔值和对象等。下面分别介绍如何>输出这些类型的信息：

浮点数：使用 %!f(MISSING) 格式化符号输出浮点数
double pi = 3.1415926;
qDebug() << "PI = " << QString::number(pi, 'f', 2);
1
2
输出结果为：

PI = 3.14

布尔值：使用 %! (MISSING)和 %! (MISSING)格式化符号输出布尔值
bool flag = true;
qDebug() << "Flag = " << (flag ? "true" : "false");
1
2
输出结果为：
Flag = true

对象：使用 qPrintable() 函数输出对象的信息
QPoint pt(10, 20);
qDebug() << "Point = " << qPrintable(pt.toString());
1
2
输出结果为：

Point = QPoint(10, 20)

需要注意的是，qDebug 输出的信息只在调试模式下有效，因此在发布程序时应该尽可能避免使用 qDebug 输出调试信息。可以使用 qInfo、qWarning 或 qCritical 输出不同级别的信息，以便在发布程序时更好地控制输出。

qInfo
在Qt中使用qInfo输出提示信息是非常简单的，只需要包含#include 和#include 这两个头文件即可。其中QLoggingCategory头文件定义了日志类别，而QtDebug头文件定义了用于调试的一系列宏。
在输出提示信息之前，我们需要设置日志类别。我们可以通过以下语句设置日志类别：

QLoggingCategory::setFilterRules(".debug=true\n.warning=false");
1
这句话的意思是将所有debug级别的信息输出，将所有warning级别的信息过滤掉。

然后我们就可以使用qInfo来输出提示信息了。
qInfo有多种使用方式，可以输出不同类型的提示信息，例如：

qInfo() << "This is an informational message."; 
qInfo("This is an informational message with a category: %!s(MISSING)", QLoggingCategory::defaultCategory()->categoryName().toUtf8().constData()); 
qInfo() << "The > time is" << QTime::currentTime();
1
2
3
第一种方式是最简单的方式，它可以输出一个简单的提示信息。
第二种方式可以将信息分类，方便我们查看和管理不同类型的信息。
第三种方式可以输出一些带参数的信息，例如当前时间。

除了qInfo之外，Qt中还提供了其他的输出提示信息的函数，例如qWarning、qCritical和qFatal等。它们分别用于输出警告、错误和致命错误信息，使用方式与qInfo类似。

最后需要注意的是，在发布版本中，我们应该关闭所有输出提示信息的功能，以提高程序的性能和安全性。我们可以通过设置日志类别来实现这一点，例如：

QLoggingCategory::setFilterRules(".debug=false\n.warning=false\n*.error=false\n*.fatal=false");
这句话的意思是将所有级别的信息都过滤掉，从而关闭输出提示信息的功能。

qWarning
在Qt中使用qWarning输出警告信息也很简单，只需要包含#include 头文件即可。和qInfo类似，我们也可以使用qWarning来输出不同类型的警告信息。

例如：

qWarning() << "This is a warning message."; 
qWarning("This is a warning message with a category: %!!(MISSING)s(MISSING)", QLoggingCategory::defaultCategory()->>categoryName().toUtf8().constData()); 
qWarning() << "The input value is invalid: " << inputValue;
1
2
3
第一种方式是最简单的方式，它可以输出一个简单的警告信息。
第二种方式可以将信息分类，方便我们查看和管理不同类型的信息。
第三种方式可以输出一些带参数的信息，例如输入值无效的警告信息。

需要注意的是，qWarning的使用和qInfo类似，但输出的信息应该是一些警告信息，而不是一些普通的提示信息。在程序开发中，我们应该根据需要使用不同的输出机制，以便更好地管理和调试程序。

qCritical
在Qt中使用qCritical输出错误信息也很简单，只需要包含#include 头文件即可。和qInfo和qWarning类似，我们也可以使用qCritical来输出不同类型的错误信息。

例如：

qCritical() << "This is a critical error message."; 
qCritical("This is a critical error message with a category: %!!(MISSING)!(MISSING)s(MISSING)", >QLoggingCategory::defaultCategory()->categoryName().toUtf8().constData()); 
qCritical() << "The file cannot be opened: " << fileName;
1
2
3
第一种方式是最简单的方式，它可以输出一个简单的错误信息。

第二种方式可以将信息分类，方便我们查看和管理不同类型的信息。

第三种方式可以输出一些带参数的信息，例如文件无法打开的错误信息。

需要注意的是，qCritical的使用和qInfo、qWarning类似，但输出的信息应该是一些严重的错误信息，例如文件无法打开、内存分配失败等。在程序开发中，我们应该根据需要使用不同的输出机制，以便更好地管理和调试程序。

自定义信息输出格式
在Qt中自定义信息输出格式可以通过qInstallMessageHandler函数来实现，该函数可以安装一个自定义的消息处理程序，用于处理Qt中的所有消息。
例如，我们可以创建一个名为myMessageOutput的函数，用于处理输出信息，并将它安装为消息处理程序。在该函数中，我们可以使用QString::asprintf函数来设置输出信息的格式，例如添加时间戳、文件名和行号等。
示例代码如下：

#include <QtDebug>

void myMessageOutput(QtMsgType type, const QMessageLogContext& context, const QString& msg)
{
   QByteArray localMsg = msg.toLocal8Bit();
   switch (type) {
   case QtDebugMsg:
       fprintf(stderr, "[%!s(MISSING)] Debug: %!s(MISSING) (%!s(MISSING):%!u(MISSING), %!s(MISSING))\n", QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz").toUtf8().constData(), localMsg.constData(), context.file, context.line, context.function);
       break;
   case QtInfoMsg:
       fprintf(stderr, "[%!s(MISSING)] Info: %!s(MISSING) (%!s(MISSING):%!u(MISSING), %!s(MISSING))\n", QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz").toUtf8().constData(), localMsg.constData(), context.file, context.line, context.function);
       break;
   case QtWarningMsg:
       fprintf(stderr, "[%!s(MISSING)] Warning: %!s(MISSING) (%!s(MISSING):%!u(MISSING), %!s(MISSING))\n", QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz").toUtf8().constData(), localMsg.constData(), context.file, context.line, context.function);
       break;
   case QtCriticalMsg:
       fprintf(stderr, "[%!s(MISSING)] Critical: %!s(MISSING) (%!s(MISSING):%!u(MISSING), %!s(MISSING))\n", QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz").toUtf8().constData(), localMsg.constData(), context.file, context.line, context.function);
       break;
   case QtFatalMsg:
       fprintf(stderr, "[%!s(MISSING)] Fatal: %!s(MISSING) (%!s(MISSING):%!u(MISSING), %!s(MISSING))\n", QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz").toUtf8().constData(), localMsg.constData(), context.file, context.line, context.function);
       abort();
   }
}

int main(int argc, char *argv[])
{
   qInstallMessageHandler(myMessageOutput);

   // 程序代码

   return 0;
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
在该示例代码中，我们创建了一个名为myMessageOutput的函数，用于处理输出信息。在该函数中，我们使用QString::asprintf函数来设置输出信息的格式，例如添加时间戳、文件名和行号等。然后，我们使用qInstallMessageHandler函数将myMessageOutput函数安装为消息处理程序，从而实现自定义信息输出格式的功能。
需要注意的是，在自定义信息输出格式时，我们应该根据需要添加所需的信息，但不要添加过多的信息，以免影响程序的性能和可读性。同时，在发布版本中，我们应该关闭所有输出提示信息的功能，以提高程序的性能和安全性。

不同输出方式的区别和底层逻辑
在Qt中，qDebug、qInfo、qWarning和qCritical是用于输出不同级别信息的函数，它们分别对应调试信息、提示信息、警告信息和错误信息。它们的区别和底层逻辑如下：

qDebug qDebug是用于输出调试信息的函数，它的输出级别最低，可以输出一些调试信息，例如变量的值、程序的运行状态等。在发布版本中，该函数的输出信息会被自动过滤掉，从而不会影响程序的性能和安全性。
底层逻辑：qDebug函数实际上是一个宏，它会在编译时根据当前编译环境的设置，将调试信息输出到标准输出流（stdout）中。
qInfo qInfo是用于输出提示信息的函数，它的输出级别比qDebug高，可以输出一些重要的提示信息，例如程序的运行状态、用户的操作等。
底层逻辑：qInfo函数实际上是一个宏，它会在编译时根据当前编译环境的设置，将提示信息输出到标准输出流（stdout）中。
qWarning qWarning是用于输出警告信息的函数，它的输出级别比qInfo高，可以输出一些警告信息，例如输入值无效、文件无法打开等。在发布版本中，该函数的输出信息会被自动过滤掉，从而不会影响程序的性能和安全性。
底层逻辑：qWarning函数实际上是一个宏，它会在编译时根据当前编译环境的设置，将警告信息输出到标准错误流（stderr）中。
qCritical qCritical是用于输出错误信息的函数，它的输出级别最高，可以输出一些严重的错误信息，例如内存分配失败、数据库连接失败等。
底层逻辑：qCritical函数实际上是一个宏，它会在编译时根据当前编译环境的设置，将错误信息输出到标准错误流（stderr）中。
总的来说，这些函数的区别在于输出信息的级别和类型不同，底层逻辑也有所区别。在程序开发中，我们应该根据需要使用不同的输出机制，以便更好地管理和调试程序。

进一步探讨
在Qt框架中，qDebug、qInfo、qWarning和qCritical是用于输出不同级别信息的函数，它们分别用于输出调试信息、提示信息、警告信息和错误信息。为了更深入理解它们的底层实现，我们可以从几个方面进行探讨：

宏的工作方式：

这些函数实际上是宏，而不是传统意义上的函数。在C++中，宏是一种预处理指令，它们在编译之前由预处理器进行处理。这意味着这些宏在编译时会被替换为相应的代码。
输出流：

qDebug和qInfo通常将输出重定向到标准输出流（stdout），而qWarning和qCritical通常将输出重定向到标准错误流（stderr）。这是因为警告和错误通常被视为需要特别注意的信息，而将它们发送到标准错误流可以使它们更容易被监控和处理。
条件编译：

在Qt中，可以通过定义或取消定义宏（例如QT_NO_DEBUG_OUTPUT）来控制这些函数的行为。这意味着在发布版本中，可以通过编译选项来禁用qDebug的输出，以提高程序的性能。
消息处理器：

Qt允许开发者安装自定义的消息处理器。这意味着开发者可以定义一个函数来处理这些宏生成的所有消息，并且可以决定如何显示、记录或忽略这些消息。
底层实现：

在底层，当这些宏被执行时，它们会创建一个临时的QDebug对象。这个对象提供了一个流式接口，用于构建最终的输出消息。当这个临时对象被销毁时，它会将累积的消息输出到相应的流中。
线程安全性：

这些宏在设计时考虑了线程安全性。在多线程环境中使用这些宏不会导致数据竞争或其他并发问题。
综上所述，这些函数的底层实现涉及宏的展开、消息的构建、条件编译以及输出重定向等多个方面。在使用这些功能时，理解它们的工作原理有助于更有效地进行调试和日志记录。

改变重定向方式
在Qt中，您可以改变qDebug、qInfo、qWarning和qCritical这些函数的默认重定向行为。Qt提供了灵活的机制来自定义日志消息的处理，包括重定向输出到不同的地方。这通常是通过安装自定义的消息处理器来实现的。以下是实现这一功能的基本步骤：

1. 定义自定义消息处理器
您可以定义一个自定义的消息处理器函数。这个函数将接收消息的类型和上下文信息，并决定如何处理这些消息。例如，您可以将消息写入文件、发送到网络日志服务或者以其他方式处理。

void customMessageHandler(QtMsgType type, const QMessageLogContext &context, const QString &msg) {
    // 根据消息类型（type）处理消息
    // 比如重定向到文件、控制台或者其他地方
}
1
2
3
4
2. 安装消息处理器
在您的应用程序初始化过程中，您可以安装这个自定义的消息处理器。这通常在main函数中完成。

int main(int argc, char *argv[]) {
    QApplication app(argc, argv);

    qInstallMessageHandler(customMessageHandler); // 安装自定义处理器

    // ... 其他应用程序初始化代码 ...

    return app.exec();
}
1
2
3
4
5
6
7
8
9
3. 实现重定向逻辑
在您的自定义消息处理器中，您可以根据消息的类型和内容决定如何重定向这些消息。例如，您可以将调试消息写入一个日志文件，将警告消息发送到控制台等。

注意事项
当您安装了自定义消息处理器后，所有通过qDebug、qInfo、qWarning和qCritical发出的消息都将通过这个处理器进行处理。
请确保您的消息处理器能够快速地处理消息，避免引入性能瓶颈。
自定义消息处理器应该是线程安全的，因为它可能被应用程序的不同线程同时调用。
通过这种方式，您可以完全控制Qt应用程序中日志消息的处理和重定向，从而适应您的特定需求。

总结
在 Qt 中，信息输出是调试和排错工作中不可或缺的一部分。Qt 提供了多种信息输出机制，包括 qDebug、qInfo、qWarning 和 qCritical 等，每种机制都有不同的作用和使用场景。在使用时，需要根据实际需求选择合适的信息输出机制，并注意输出信息的类型和格式。
QDebug 是 Qt 中最常用的信息输出机制，可以输出各种调试信息；qInfo 是用于输出提示信息的机制；qWarning 是用于输出警告信息的机制；qCritical 是用于输出错误信息的机制。除了这些基本机制外，Qt 还提供了自定义信息输出格式的功能，可以根据需要设置时间戳、文件名和行号等信息。
在使用信息输出机制时，需要注意避免过度使用，以免影响程序的性能。同时，还需要根据实际需求选择合适的信息输出级别，以便快速定位和解决问题。
————————————————

                            版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
                        
原文链接：https://blog.csdn.net/qq_21438461/article/details/129795643