3、告别printf，拥抱QDebug：printf与qDebug()的区别、QDebug的格式化输出、日志分类与文件输出、在Qt中保留C的printf

说实话，我从C语言转到Qt开发那会儿，最不习惯的就是调试输出。

以前写C代码，调试全靠printf。满屏幕的格式化字符串，找bug就跟大海捞针一样。后来做Qt项目，我发现很多老同事还在用printf，我就问他们：你们怎么不用qDebug？他们回答：用惯了，懒得改。

嗯，这个心态我特别理解。但今天我想认真跟你聊聊，为什么我建议你尽早拥抱QDebug。

printf与qDebug()：到底差在哪？

先看一个最简单的对比：

// C风格
printf("x = %d, y = %f\n", x, y);

// Qt风格
qDebug() << "x =" << x << "y =" << y;

表面上看，qDebug()更简洁。但真正的区别不在写法上。

核心区别有三点：

• 类型安全：printf靠格式化字符串匹配，写错%d和%f就崩。qDebug()靠C++流操作符，编译器帮你检查类型。我在项目中遇到过好几次，printf的格式串写错了，线上跑着跑着就段错误，查了半天才发现是%d传了个double。
• 可重定向：printf只能往标准输出写。qDebug()可以重定向到文件、网络、甚至自定义的日志窗口。你想想看，嵌入式设备上没屏幕，printf打出来你看得见吗？
• 可过滤：qDebug()可以按类别、级别过滤输出。printf做不到。

QDebug的格式化输出：比你想象的强大

很多人觉得qDebug()只能打印基本类型，其实不然。

看几个例子：

// 打印QString
QString name = "张三";
qDebug() << "姓名:" << name;

// 打印QPoint
QPoint pt(10, 20);
qDebug() << "坐标:" << pt;

// 打印QList
QList<int> list = {1, 2, 3, 4};
qDebug() << "列表:" << list;

// 打印自定义结构体
struct Person {
    QString name;
    int age;
};
QDebug operator<<(QDebug debug, const Person &p) {
    QDebugStateSaver saver(debug);
    debug.nospace() << "Person(" << p.name << ", " << p.age << ")";
    return debug;
}
Person p{"李四", 25};
qDebug() << p;

我个人习惯给所有自定义数据结构都重载一个<<操作符。这样调试的时候，一行qDebug()就能看到完整信息，不用再写一堆printf拼字符串。

日志分类与文件输出：这才是QDebug的杀手锏

项目大了以后，调试信息会变得非常杂乱。你想想看，网络模块的日志、UI模块的日志、数据库模块的日志全混在一起，你怎么找问题？

Qt提供了QLoggingCategory来解决这个问题。

// 定义日志分类
Q_LOGGING_CATEGORY(logNetwork, "app.network")
Q_LOGGING_CATEGORY(logDatabase, "app.database")
Q_LOGGING_CATEGORY(logUI,      "app.ui")

// 使用分类输出
qCDebug(logNetwork) << "连接成功";
qCDebug(logDatabase) << "查询耗时:" << elapsed << "ms";
qCDebug(logUI) << "按钮被点击";

然后你可以单独控制每个分类的日志级别：

// 只开启网络模块的调试日志
QLoggingCategory::setFilterRules("app.network.debug=true\n"
                                 "app.database.debug=false\n"
                                 "app.ui.debug=false");

我曾经在一个大型项目中，用这个功能把日志输出量减少了80%。以前全量日志一天能写几个GB，根本没法分析。分类之后，我只关注出问题的模块，效率提升非常明显。

文件输出怎么做？

Qt提供了qInstallMessageHandler，你可以接管所有的日志输出：

void customMessageHandler(QtMsgType type, const QMessageLogContext &context, const QString &msg) {
    // 写入文件
    QFile file("app.log");
    if (file.open(QIODevice::Append | QIODevice::Text)) {
        QTextStream stream(&file);
        stream << QDateTime::currentDateTime().toString("yyyy-MM-dd hh:mm:ss.zzz ") << msg << "\n";
        file.close();
    }
}

// 在main函数中安装
int main(int argc, char *argv[]) {
    qInstallMessageHandler(customMessageHandler);
    // ...
}

在Qt中保留C的printf：有时候还是得用

说了这么多qDebug()的好处，但我也得承认，有些场景下printf还是有用武之地的。

什么时候该用printf？

• 极简环境：比如某些嵌入式Qt版本没有QDebug支持，或者你只想快速打印一行信息。
• 性能敏感：printf的格式化输出比qDebug()的流操作快一点点。在循环中大量输出时，这个差距会累积。
• 兼容旧代码：你从C语言移植过来的代码，里面全是printf，没必要全部重写。

我的做法是：新代码用qDebug()，旧代码的printf保留不动。等后续重构时再逐步替换。

如果你想让printf和qDebug()的输出混在一起，可以这样：

// 把printf重定向到qDebug
#include <cstdio>
#include <QDebug>

void myPrintf(const char *format, ...) {
    char buf[1024];
    va_list args;
    va_start(args, format);
    vsnprintf(buf, sizeof(buf), format, args);
    va_end(args);
    qDebug() << buf;
}

// 使用
myPrintf("x = %d, y = %f\n", x, y);

这样既保留了printf的格式化习惯，又享受了qDebug的日志管理能力。

知识体系图

这张图把整个调试输出体系梳理清楚了。左边是传统的printf，右边是Qt的qDebug，中间是两者的对比。底部是我个人的实践建议。

最后说一句：调试输出这件事，看似简单，但用好了能极大提升你的开发效率。别小看它。

---

可可精品资料库