fmtlog日志库安装与配置完全指南

fmtlog日志库安装与配置完全指南

fmtlog fmtlog is a performant fmtlib-style logging library with latency in nanoseconds. 项目地址: https://gitcode.com/gh_mirrors/fm/fmtlog

项目基础介绍及编程语言

fmtlog 是一个高性能的日志库，采用了类似于fmtlib的风格，专注于提供纳秒级别的低延迟和高吞吐量。它专为C++17设计，利用了fmtlib强大的格式化功能，使得日志记录既快速又灵活。fmtlog支持异步多线程日志记录，并且能够保证时间顺序，同时也允许同步单线程使用。此外，其提供了丰富的日志级别控制、自定义处理逻辑以及过滤机制。

关键技术和框架

• 核心技术: 异步日志处理，基于事件队列的设计。
• 依赖框架: 主要依赖于fmtlib，用于实现高效的文本格式化。
• 特性亮点: 高性能（相比NanoLog和spdlog有优势）、头文件-only模式与编译版本选择、高度可定制的格式化选项、多线程安全以及动态日志级别设置等。

安装与配置步骤

准备工作

确保您的开发环境已经安装了C++17兼容的编译器（如GCC 10.2或更高版本在Linux上，MSVC 2019或更高版本在Windows上）。另外，您需要先安装fmtlib，因为fmtlog依赖于它进行格式化操作。

安装fmtlib

1. 可以通过包管理器（例如Debian/Ubuntu中的apt，或者MacOS的brew）安装，或直接从fmtlib的GitHub页面克隆并构建。

   git clone https://github.com/fmtlib/fmt.git
   cd fmt
   mkdir build && cd build
   cmake ..
   make && sudo make install
   

安装fmtlog

获取源代码

1. 克隆fmtlog项目到本地：

   git clone https://github.com/MengRao/fmtlog.git
   cd fmtlog
   

2. 初始化子模块并更新（fmtlog依赖的一些辅助文件可能存储在这里）：

   git submodule init
   git submodule update
   

头文件-only安装

对于只需要头文件的用户，只需将以下两个文件复制到您的项目目录：

• fmtlog.h
• fmtlog-inl.h

并在需要的地方定义宏FMTLOG_HEADER_ONLY或直接包括fmtlog-inl.h。

编译版本安装

如果您希望构建为静态库或共享库，可以使用CMake来完成：

1. 在fmtlog根目录下执行：

   mkdir build
   cd build
   cmake ..
   make
   

2. 这将会生成libfmtlog-static.a（静态库）或libfmtlog-shared.so（共享库）在build目录下。

设置日志文件

为了将日志输出到文件而非标准输出，需要调用：

fmtlog::setLogFile("path/to/your/logfile.log", true); // true表示清空已有内容

示例：集成到您的项目中

1. 将必要的头文件路径添加到您的编译器搜索路径。
2. 包含fmtlog/fmtlog.h并开始使用。

#include "fmtlog/fmtlog.h"

int main() {
    FMTLOG(fmtlog::INF, "初始化日志测试");
    fmtlog::setLogLevel(fmtlog::DBG); // 设置日志级别为调试
    // ...更多日志记录代码
}

测试和运行

在您的项目中集成fmtlog后，确保正确链接所需的库（如果是编译版本），然后编译并运行您的程序。对于编译版本，确保链接指令正确包含了-lfmtlog-static或-lfmtlog-shared（取决于您构建的是哪种类型的库）。

至此，您已成功安装并配置了fmtlog日志库，可以开始在您的C++项目中享受高效便捷的日志服务了。

fmtlog fmtlog is a performant fmtlib-style logging library with latency in nanoseconds. 项目地址: https://gitcode.com/gh_mirrors/fm/fmtlog