【Qt】Qt日志-自定义日志格式和输出位置

在 Qt 中处理日志通常涉及使用内置的日志系统，可以通过 qDebug()、qInfo()、qWarning()、qCritical() 和 qFatal() 等宏记录日志。以下是如何高效管理 Qt 日志的完整指南：

1. 基础日志输出

默认情况下，Qt 的日志会输出到控制台：

#include <QDebug>

void testFunction() {
    qDebug() << "This is a debug message";
    qInfo() << "Application started";
    qWarning() << "Unexpected value detected";
    qCritical() << "Critical error occurred";
    // qFatal() 会终止程序
}

2. 自定义日志格式和输出位置

通过 qInstallMessageHandler 重定向日志，例如将日志写入文件：

#include <QtGlobal>
#include <QFile>
#include <QTextStream>
#include <QDateTime>

void logHandler(QtMsgType type, const QMessageLogContext &context, const QString &msg) {
    QByteArray localMsg = msg.toLocal8Bit();
    const char* level = "";
    switch (type) {
        case QtDebugMsg:    level = "DEBUG"; break;
        case QtInfoMsg:     level = "INFO"; break;
        case QtWarningMsg:  level = "WARN"; break;
        case QtCriticalMsg: level = "ERROR"; break;
        case QtFatalMsg:   level = "FATAL"; break;
    }

    QString logLine = QString("[%1] %2: %3 (%4:%5, %6)\n")
        .arg(QDateTime::currentDateTime().toString("yyyy-MM-dd HH:mm:ss.zzz"))
        .arg(level)
        .arg(localMsg.constData())
        .arg(context.file)
        .arg(context.line)
        .arg(context.function);

    // 写入文件（示例路径，建议使用 QStandardPaths 获取合适路径）
    QFile file("app_log.txt");
    if (file.open(QIODevice::WriteOnly | QIODevice::Append)) {
        QTextStream stream(&file);
        stream << logLine;
        file.close();
    }

    // 可选：同时输出到控制台
#ifdef QT_DEBUG
    fprintf(stderr, "%s", logLine.toUtf8().constData());
#endif
}

// 在 main() 中安装处理函数
int main(int argc, char *argv[]) {
    qInstallMessageHandler(logHandler);
    QApplication app(argc, argv);
    // ...
    return app.exec();
}

3. 日志分类与过滤

使用 QLoggingCategory 对日志进行分类管理：

#include <QLoggingCategory>

// 定义分类
Q_LOGGING_CATEGORY(networkLog, "network")
Q_LOGGING_CATEGORY(databaseLog, "database")

void networkRequest() {
    qCDebug(networkLog) << "Sending request to server...";
    qCWarning(databaseLog) << "Database connection timeout";
}

// 在配置中禁用特定分类的日志
int main() {
    QLoggingCategory::setFilterRules("network.debug=false\ndatabase.warning=true");
    // ...
}

4. 高级技巧

• 日志轮转 (Log Rotation)
  定期检查日志文件大小，分割旧日志：

  void rotateLogs() {
      QFile file("app_log.txt");
      if (file.size() > 10 * 1024 * 1024) { // 10MB
          QDateTime now = QDateTime::currentDateTime();
          file.rename(QString("app_log_%1.txt").arg(now.toString("yyyyMMdd_hhmmss")));
          file.open(QIODevice::WriteOnly); // 创建新文件
          file.close();
      }
  }
  

• 发布版本禁用调试日志
  在 .pro 文件中通过条件编译控制日志级别：

  # Release 模式禁用 DEBUG 日志
  CONFIG(release, debug|release) {
      DEFINES += QT_NO_DEBUG_OUTPUT
  }
  

• 多线程安全
  确保日志写入操作是线程安全的（例如使用互斥锁）。

5. 常见问题

• 日志不显示？
  检查是否在 Release 模式下禁用了日志（默认行为），或在 main() 中未安装处理函数。

• 日志文件权限问题
  在 Linux/macOS 下确保应用有写入权限，或使用 QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) 获取合适路径。