qDebug 消息格式化输出至文件

简述

在平时调试时，我们一般选择用qDebug 打印输出我们需要的消息，但当程序发布以后的问题追踪，qDebug 很明显不够用，它的消息输出以后无法保存，也没有日期时间，以及日志输出位置的标注。这时候就需要我们改造一下它了。先格式化输出，格式化输出有两种方法，先看第一种。

格式化输出一

自定义一个消息器（其实就是一个回调函数）

#include "stdio.h"
#include "stdlib.h"
#include <QString>
#include <QMessageLogContext>

void myMessageOutput(QtMsgType type, const QMessageLogContext &context, const QString &msg)
{
    QByteArray localMsg = msg.toLocal8Bit();
    switch (type) {
    case QtDebugMsg:
        fprintf(stderr, "Debug: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line, context.function);
        break;
    case QtInfoMsg:
        fprintf(stderr, "Info: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line, context.function);
        break;
    case QtWarningMsg:
        fprintf(stderr, "Warning: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line, context.function);
        break;
    case QtCriticalMsg:
        fprintf(stderr, "Critical: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line, context.function);
        break;
    case QtFatalMsg:
        fprintf(stderr, "Fatal: %s (%s:%u, %s)\n", localMsg.constData(), context.file, context.line, context.function);
        abort();
    }
}

• type： 消息等级，为 QtMsgType 的枚举类型变量
• context： 是一个 QMessageLogContext 类型，里面包含了文件，行号，函数等信息
• msg：是一个QString 类型，为 qDebug 输出的消息

接下来安装并测试消息器

安装消息器

int main(int , char **)
{
    qInstallMessageHandler(myMessageOutput);//安装消息器
    qDebug("Qt Message"); //打印数据测试消息器
    qWarning("Qt Message");
    qInfo("Qt Message");
    qCritical("Qt Message");
    qInstallMessageHandler(0);//如果不需要消息器了，可以这样卸载消息器
    return 0;
}

输出数据

Debug: Qt Message (…\main.cpp:31, int main(int, char**))
Warning: Qt Message (…\main.cpp:32, int main(int, char**))
Info: Qt Message (…\main.cpp:33, int main(int, char**))
Critical: Qt Message (…\main.cpp:34, int main(int, char**))

输出数据中包含了qDebug 的消息和输出消息所在文件目录、行号、函数名。

格式化输出二

#include <QDebug>

int main(int , char **)
{
    //设置qDebug 输出格式
    qSetMessagePattern("[%{time yyyy-MM-dd hh:mm:ss ddd} %{file} %{line} %{function}] %{message}");

    qDebug("Qt Message");
    qWarning("Qt Message");
    qInfo("Qt Message");
    qCritical("Qt Message");

    return 0;
}

输出

[2020-03-21 00:06:14 周六 …\untitled5\main.cpp 32 main] Qt Message
[2020-03-21 00:06:14 周六 …\untitled5\main.cpp 33 main] Qt Message
[2020-03-21 00:06:14 周六 …\untitled5\main.cpp 34 main] Qt Message
[2020-03-21 00:06:14 周六 …\untitled5\main.cpp 35 main] Qt Message

qSetMessagePattern 是Qt 自带的一个全局函数，利用这个全局函数设置输出格式，看起来比第一种简单方便很多。更多格式定义

输出至文件

#include "stdio.h"
#include "stdlib.h"
#include <QString>
#include <QMessageLogContext>
#include <QFile>

void myMessageOutput(QtMsgType type, const QMessageLogContext &context, const QString &msg)
{
    QString message;
    message = qFormatLogMessage(type, context, msg); //获取 qSetMessagePattern 设置的格式
    message.append("\r\n");

    QFile file("./log.txt");
    if(file.open(QFile::WriteOnly | QFile::Append)) {
        file.write(message.toLocal8Bit());
    }
    file.close();
}

int main(int , char **)
{
    //设置qDebug 输出格式
    qSetMessagePattern("[%{time yyyy-MM-dd hh:mm:ss ddd} %{file} %{line} %{function}] %{message}");
    //安装消息器
    qInstallMessageHandler(myMessageOutput);

    qDebug("Qt Message");
    qWarning("Qt Message");
    qInfo("Qt Message");
    qCritical("Qt Message");

    return 0;
}