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

【Qt开发】调试log日志QDebug重定向输出到textEdit等控件（qInstallMessageHandler回调函数）

news 2026/1/28 1:02:00

文章目录

Log输出方式
qInstallMessageHandler回调函数
线程安全
textEdit控件
附录：C语言到C++的入门知识点（主要适用于C语言精通到Qt的C++开发入门）
- C语言与C++的不同
- C++中写C语言代码
- C语言到C++的知识点
- Qt开发中需要了解的C++基础知识
- - namespace
  - 输入输出
  - 字符串类型
  - class类
  - - 构造函数和析构函数（解析函数）
    - 类的继承

Log输出方式

Qt有Debug、Warning、Info、Critical、Fatal五种级别的调试信息。

qDebug--------调试信息
qWarning--------警告信息
qInfo--------警告信息
qCritical--------严重错误
qFatal--------致命错误

分别由qDebug、qWarning、qCritical、qFatal等函数进行调用

调用时与cout用法相同
如：

qDebug()<<"timerEvent 1\n";

在进行调试时可以输出到IDE的终端下面但是不会在窗口中显示
为了输出到窗口则需要进行重定向

qInstallMessageHandler回调函数

Qt5提供了qInstallMessageHandler函数
用于申请一个回调

函数原型：

typedef void (*QtMessageHandler)(QtMsgType, const QMessageLogContext &, const QString &);
Q_CORE_EXPORT QtMessageHandler qInstallMessageHandler(QtMessageHandler);

申请后每次发生QDebug等数据都会跳到回调中

我的回调函数如下：

void myMessageOutput(QtMsgType type, const QMessageLogContext &context, const QString &msg)
{static QMutex MessageOutput_Mutex;MessageOutput_Mutex.lock();(void)context;QByteArray localMsg = msg.toLocal8Bit();//信息分类QString strMsg("");switch(type){case QtDebugMsg:strMsg = QString("Debug:");break;case QtInfoMsg:strMsg = QString("Info:");break;case QtWarningMsg:strMsg = QString("Warning:");break;case QtCriticalMsg:strMsg = QString("Critical:");break;case QtFatalMsg:strMsg = QString("Fatal:");break;default:break;}// 设置输出信息格式QString strDateTime = QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz");QString strMessage = QString("%1 %2 %3").arg(strDateTime,strMsg,localMsg.constData());pw->debug_text->insertPlainText(strMessage);MessageOutput_Mutex.unlock();
}

注册方法：

qInstallMessageHandler(myMessageOutput);

几种传参就是类型、位置和消息内容
context位置包括被调用时的文件名、函数名称、行数等等

由于我是直接用Qt Creator直接生成的工程 MainWindow定义的w在mian函数中调用
所以需要用一个全局变量转一下

MainWindow *pw = nullptr;
int main(int argc, char *argv[])
{QApplication a(argc, argv);MainWindow w;pw=&w;w.show();return a.exec();
}

消息处理后用

pw->debug_text->insertPlainText(strMessage);

发送到textEdit控件

最终效果
在这里插入图片描述

线程安全

如果你用到了多线程则可能多次调用QDebug 造成多次回调
则为了安全加了一个互斥锁

    static QMutex MessageOutput_Mutex;MessageOutput_Mutex.lock();

和

MessageOutput_Mutex.unlock();

textEdit控件

定义就不讲了我是用ui直接设计的但设计的出来都是私有成员所以得加个公有成员指向他

QTextEdit *debug_text;
debug_text=this->ui->textEdit_2;

可以用函数设置最大行数

debug_text->document()->setMaximumBlockCount(500);

另外在槽函数textChanged()中加入下拉框置底的配置

void MainWindow::on_textEdit_2_textChanged()
{this->ui->textEdit_2->moveCursor(QTextCursor::End);
}

附录：C语言到C++的入门知识点（主要适用于C语言精通到Qt的C++开发入门）

C语言与C++的不同

C语言是一门主要是面向工程的语言
C++则是面向对象

C语言中某些功能实现起来较为繁琐
比如结构体定义：

一般写作：

typedef struct stu_A
{
}A;

也可以写作：

typedef struct 
{
}A;

但大括号后面的名称是不可省去的

不过 C++的写法就比较简单
除了支持上述写法外

也支持直接声明

typedef struct A
{
}

另外 C++是完全支持C语言库和语法的
不过C++里面的库也有些很方便的高级功能用法只不过实现起来可能不如C的速度快

再者 C语言与C++的编译流程不一样
C语言没有函数重载所以给编译器传参就是直接传函数名称
但是C++除了传函数名称外还会穿函数的参数、类型等等以实现函数重载

C++中写C语言代码

上文提到 C++可以完全兼容C的写法
但是编译流程也还是不一样
所以如果在编译层面进行C语言代码编译则通常用以下方法：

extern "C"
{
...
}

表面大括号内的内容用C的方法进行编译

另外如果还是用C++的编译器但要实现C语言函数则需要用到C语言的库

在C语言中我们一般用如下方法导入库

#include <stdio.h>

此方法同样适用于C++ 但是C++可以更方便的写成去掉.h的方式
比如：

#include <iostream>

在C++中为了调用C语言的库可以采用在原库名称前加一个"c"的方式导入
如：

#include <cstdio>

这样就可以使用printf等函数了甚至比C++的std方法更快

C语言到C++的知识点

在这里插入图片描述

Qt开发中需要了解的C++基础知识

namespace

C++面向对象的特性下诞生的一个名称
表示某个函数、变量在某个集合下用作namespace
比如 <iostream>库中的关键字cin在std下则写作std::cin
std就是namespace
::表示某空间下的某某
前面是空间名称后面是变量、函数名称

用using namespace可以告诉编译器以下都用xx名称空间
比如：

using namespace std;
cout<<"a";

如果没有告诉编译器所使用的空间名称则要写成：

std::cout<<"a";

同样可以自定义某一段代码属于哪个空间：

namespace xx
{
...
}

输入输出

在C++中用iostream作为输入输出流的库

#include <iostream>

用cin和cout关键字进行输入和输出
如：

using namespace std;
int a=0;
cin>>a; //输入到acout<<a;  //输出a

类比scanf和printf
同样还有一个关键字endl表示换行
cout和cin的传参是不固定的
由编译器自行裁定

字符串类型

在C语言中常用char *表示字符串
但是在C++中可以直接用string类型
比如：

char * s="456";
string str="123";

由于cout的特性这两种字符串都可以直接打印
但如果使用C语言中printf的打印方式时采用%s方式打印字符串则不能传入string类型

class类

C++的核心就是class
同Python等支持面向对象的语言一样
可以理解成一个支持函数、继承、自动初始化、销毁的结构体
在class类中有private私有、public公有变量
前者只能内部访问后者可以外部调用使用
如：

class A
{
public:
int a;
private:
int b;
}

a可以用A.a的方式方位 b则外部无法访问

构造函数和析构函数（解析函数）

构造函数可以理解成对类的初始化反之析构函数则是退出时进行销毁前的函数
两者需要与类的名称相同析构函数则在前面加一个~表示非
如：

class A
{
public:
int a;
A();
~A();
private:
int b;
}A::A()
{
...
}A::~A()
{
...
}

构造函数可以定义传参析构函数则不行

类的继承

如果有两个类A和B 想让A里面包含B 则可以写作继承的写法
继承后 A类的变量可以直接调用B下面的成员
如：

class B
{
int b;
}
class A: public B
{
int a;
}

在定义A后可以访问到B的成员b 当然继承也可以私有