# qlogger

**Repository Path**: wolfism/qlogger

## Basic Information

- **Project Name**: qlogger
- **Description**: qt轻量日志
- **Primary Language**: Unknown
- **License**: LGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-01
- **Last Updated**: 2026-03-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# QLogger

QLogger 是一个基于 Qt 的日志库，支持线程安全的异步日志处理，可以作为动态库被其他项目调用。

## 特性

- 支持不同级别的日志（Debug, Info, Warning, Error, Fatal）
- 支持日志级别过滤
- 支持输出到控制台和文件
- 线程安全
- 异步日志处理，不会阻塞主程序
- 直接使用 Qt 自带的日志函数（qDebug(), qInfo(), qWarning(), qCritical()）
- 自定义日志格式：`日志级别# 时间# 文件-行数# 函数名# 线程号# 日志内容`
- 可配置是否包含函数名和线程号

## 安装

1. 使用 qlog.pro 管理和构建项目：
   ```bash
   cd q5log
   qmake qlog.pro
   make
   ```

2. 或者单独编译 QLogger 库：
   ```bash
   cd q5log/qlogger
   qmake
   make
   ```

3. 安装库（可选）：
   ```bash
   sudo make install
   ```

## 使用

1. 在项目中包含 QLogger 头文件：
   ```cpp
   #include "qlogger.h"
   ```

2. 初始化日志库：
   ```cpp
   
   QLogger::instance()->setLogFile("log.txt");// 设置日志文件路径
   // 其他设置...
   QLogger::instance()->start();              // 启动日志系统
   ```

3. 使用 Qt 自带的日志函数输出日志：
   ```cpp
   #include <QDebug>
   // ...
   qDebug() << "This is a debug message";
   qInfo() << "This is an info message";
   qWarning() << "This is a warning message";
   qCritical() << "This is an error message";
   ```

## 配置

- `setLogLevel(QtMsgType level)`：设置日志级别，低于该级别的日志不会被记录
- `setLogFile(const QString& path)`：设置日志文件路径，为空时使用默认值（应用程序路径.log）
- `setMaxFileSize(qint64 size)`：设置最大文件大小（字节），默认10MB
- `setMaxFileCount(int count)`：设置最大文件个数，默认10个
- `setIncludeFunction(bool include)`：设置是否包含函数名，当 level 为 QtDebugMsg 时默认true，其他模式默认false
- `setIncludeThread(bool include)`：设置是否包含线程号，当 level 为 QtDebugMsg 时默认true，其他模式默认false
- `setOutputToConsole(bool output)`：设置是否输出到控制台，当 level 为 QtDebugMsg 时默认true，其他模式默认false
- `start()`：启动日志系统，创建线程并打开日志文件

## 日志级别

- `QtDebugMsg`：调试信息
- `QtInfoMsg`：一般信息
- `QtWarningMsg`：警告信息
- `QtCriticalMsg`：错误信息
- `QtFatalMsg`：致命错误信息