c++怎么使用spdlog库来记录高性能日志_C++高性能日志库spdlog使用指南

使用spdlog可轻松实现高性能日志记录。它是一个C++11头文件-only库，无需编译，支持通过vcpkg或手动集成。包含主头文件后即可用spdlog::info等接口输出日志，默认打印到控制台并支持格式化。可通过basic_logger_mt创建文件日志器，daily_logger_mt实现每日滚动日志，或组合多个sinks实现多目标输出。性能优化关键包括启用异步日志（init_thread_pool）、设置刷新策略（set_flush_on）、定制高效日志格式（set_pattern）及编译期日志级别过滤（SPDLOG_ACTIVE_LEVEL）。最佳实践建议使用try-catch处理异常、复用logger实例、设置默认logger并调用spdlog::shutdown()确保日志完整写入。合理配置下，spdlog能高效支撑高并发场景。

使用spdlog记录高性能日志非常简单，它是一个基于C++11的轻量级、无锁（可选）、高速的日志库，性能远超传统方案。下面介绍如何快速集成和高效使用spdlog。

安装与配置spdlog

spdlog是头文件-only库，无需编译，直接包含即可使用：

• 通过vcpkg或conan等包管理器安装：vcpkg install spdlog
• 手动下载：从GitHub克隆spdlog仓库，将include目录加入项目包含路径
• 在代码中包含主头文件：#include

基本日志输出

最简单的用法是使用默认日志器：

#include 
int main() {
    spdlog::info("程序启动成功");
    spdlog::warn("这是一个警告");
    spdlog::error("发生错误: {}", "文件未找到");
    return 0;
}

默认日志输出到控制台，支持格式化语法（类似Python的format）。

立即学习“C++免费学习笔记（深入）”；

koly.club

一站式社群管理工具

下载

创建自定义日志器

为了更灵活控制输出目标和格式，可以创建专用日志器：

• 文件日志器：记录到文件

  
  auto file_logger = spdlog::basic_logger_mt("file_logger", "app.log");
  file_logger->info("写入文件日志");
      

• 每日滚动日志：

  
  auto daily_logger = spdlog::daily_logger_mt("daily_logger", "logs/daily.txt", 23, 59);
      

• 多目标日志：同时输出到控制台和文件

  
  auto console = spdlog::stdout_color_mt("console");
  auto file = spdlog::basic_logger_mt("file", "combined.log");
  std::vector sinks{console, file};
  auto combined = std::make_shared("combined", sinks.begin(), sinks.end());
  spdlog::register_logger(combined);
      

提升性能的关键设置

spdlog之所以高性能，关键在于以下配置：

• 启用异步日志：避免主线程阻塞

  
  spdlog::init_thread_pool(8192, 1); // 线程池大小和线程数
  auto async_file = spdlog::basic_logger_mt("async", "async.log");
      

• 关闭自动刷新（按需开启）

  
  spdlog::set_flush_on(spdlog::level::err); // 只有错误时刷新
      

• 设置高效日志格式

  
  spdlog::set_pattern("[%Y-%m-%d %H:%M:%S.%e][%n][%l] %v");
      

• 编译时定义 SPDLOG_ACTIVE_LEVEL=SPDLOG_LEVEL_INFO 可在编译期过滤低级别日志，减少运行开销

错误处理与最佳实践

spdlog默认会抛出异常，建议包装使用：

• 用try-catch包裹初始化代码，防止文件路径无效等问题
• 使用spdlog::set_default_logger(your_logger)设置全局默认
• 程序退出前调用spdlog::shutdown()确保异步日志写完
• 避免在热路径频繁创建logger，应复用实例