C++高效日志记录利器（spdlog日志库从零入门到实战）

什么是spdlog？

spdlog 是一个基于 C++11 的快速、轻量级日志库，支持多线程、异步日志、格式化输出、日志级别控制、文件轮转等功能。它无需依赖第三方库，仅需包含头文件即可使用，非常适合嵌入到各类 C++ 项目中。

核心优势包括：

• 极高的性能（每秒百万条日志）
• 支持同步与异步日志模式
• 自动日志文件轮转（按大小或时间）
• 支持颜色输出（终端高亮）
• 使用 fmt 库进行高效格式化（类似 Python 的 f-string）

安装spdlog

spdlog 是 header-only 库，这意味着你只需下载源码并包含头文件即可使用。以下是几种常见安装方式：

方法一：直接下载头文件

访问 spdlog GitHub 仓库，下载最新 release 版本，解压后将 include/spdlog 目录复制到你的项目 include 路径中。

方法二：使用包管理器

例如在 Ubuntu 上使用 vcpkg：

vcpkg install spdlog

或者在 macOS 上使用 Homebrew：

brew install spdlog

第一个spdlog程序

下面是一个最简单的 spdlog 使用示例：

#include <iostream>#include "spdlog/spdlog.h"int main() {    // 初始化默认控制台日志器    spdlog::info("Hello, this is spdlog!");    spdlog::warn("This is a warning message.");    spdlog::error("An error occurred!");    return 0;}

编译时记得指定 C++11 或更高标准，并包含 spdlog 头文件路径：

g++ -std=c++11 -I./include main.cpp -o main

创建自定义日志器

你可以创建多个日志器，分别用于不同模块。例如，为网络模块和数据库模块分别创建日志器：

#include "spdlog/spdlog.h"#include "spdlog/sinks/basic_file_sink.h"int main() {    // 创建一个写入文件的 logger    auto file_logger = spdlog::basic_logger_mt("file_logger", "logs/network.log");        // 创建一个控制台 logger    auto console_logger = spdlog::stdout_color_mt("console_logger");    file_logger->info("Network connected successfully");    console_logger->warn("Database connection timeout");    // 刷新日志（确保写入磁盘）    spdlog::shutdown();    return 0;}

日志级别与格式化

spdlog 支持多种日志级别：trace、debug、info、warn、error、critical。默认最低级别为 info，可通过设置调整。

你还可以自定义日志输出格式，例如添加时间戳、线程ID等：

auto logger = spdlog::stdout_color_mt("custom");logger->set_pattern("[%Y-%m-%d %H:%M:%S.%e] [%l] [%t] %v");logger->info("Custom format example");

其中 %v 表示日志消息内容，%l 是日志级别，%t 是线程ID，%e 是毫秒。

异步日志提升性能

在高并发场景下，同步写日志可能成为性能瓶颈。spdlog 提供了异步日志模式，通过后台线程处理日志写入：

#include "spdlog/async.h"#include "spdlog/sinks/basic_file_sink.h"int main() {    // 设置异步工厂    spdlog::init_thread_pool(8192, 1);    auto async_file = spdlog::create_async<spdlog::sinks::basic_file_sink_mt>("async_file_logger", "logs/async.log");        async_file->info("This is an async log message");        spdlog::shutdown(); // 确保异步队列中的日志被处理    return 0;}

总结

通过本教程，你已经掌握了 spdlog日志库 的基本使用方法，包括安装、简单输出、自定义日志器、格式化以及异步日志。无论你是开发小型工具还是大型服务器应用，C++日志系统 都能借助 spdlog 实现高效、灵活的日志管理。

记住，良好的日志习惯能极大提升程序的可维护性。现在就将 高性能日志 功能集成到你的 C++ 项目中吧！如果你刚开始接触日志系统，这篇 spdlog入门教程 就是你最好的起点。

提示：实际项目中建议将日志配置封装成初始化函数，并统一管理日志器生命周期。