C++如何进行日志记录_使用spdlog库为C++项目添加高性能日志功能

spdlog是C++中高效线程安全的日志库，支持异步、多输出和自定义格式。1. 通过vcpkg或源码集成，头文件仅需包含即可使用。2. 基础用法包括info、warn、error等日志级别，默认需启用debug模式。3. 使用basic_logger_mt将日志写入文件，确保目录存在。4. 组合stdout_color_sinks和file_sink实现控制台与文件双输出。5. 异步日志需初始化线程池，提升高并发性能。6. 自定义格式通过set_pattern设置时间、级别、内容等占位符。7. 最佳实践建议统一配置、命名logger、生产环境用异步、合理轮转文件。

在C++项目中实现高效、线程安全且易于使用的日志功能，spdlog 是一个非常受欢迎的选择。它是一个基于现代C++（C++11及以上）的高性能日志库，支持异步日志、多线程安全、多种日志格式和输出目标（控制台、文件等），并且使用简单。

1. 安装与集成 spdlog

spdlog 是一个头文件-only 的库，因此集成非常方便，无需编译。

vcpkg install spdlog

• 从 GitHub 下载：https://github.com/gabime/spdlog
• 将 include/spdlog 目录复制到你的项目 include 路径中
• 在代码中包含即可使用

add_subdirectory(vendor/spdlog)
target_link_libraries(your_target spdlog)

2. 快速开始：基本日志输出

以下是一个简单的例子，展示如何使用 spdlog 输出日志到控制台：

#include 

int main() {
    spdlog::info("这是一条信息日志");
    spdlog::warn("这是一个警告");
    spdlog::error("这是一个错误");
    spdlog::debug("调试信息（需启用调试模式）");
    return 0;
}

默认情况下，debug 级别的日志不会显示，需要设置日志级别：

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

spdlog::set_level(spdlog::level::debug); // 启用 debug 级别

3. 使用文件日志记录

将日志写入文件是常见需求。spdlog 提供了 basic_logger_mt 来创建线程安全的文件日志器：

#include 

auto file_logger = spdlog::basic_logger_mt("file_logger", "logs/app.log");
file_logger->info("这条日志会写入文件");
file_logger->error("出错啦：无法打开文件");

确保 logs/ 目录存在，否则会抛出异常。

4. 同时输出到控制台和文件

可以组合多个 sink，实现日志同时输出到控制台和文件：

Axiom

Axiom是一个浏览器扩展，用于自动化重复任务和web抓取。

下载

#include 
#include 

auto console_sink = std::make_shared();
auto file_sink = std::make_shared("logs/app.log");

auto combined_logger = std::make_shared("multi", spdlog::sinks_init_list{console_sink, file_sink});
combined_logger->info("这条消息会同时出现在控制台和文件中");
combined_logger->set_level(spdlog::level::trace);

// 注册为默认 logger（可选）
spdlog::set_default_logger(combined_logger);

5. 异步日志提升性能

在高并发场景下，同步日志可能成为性能瓶颈。spdlog 支持异步日志，通过后台线程写入：

spdlog::init_thread_pool(8192, 1); // 队列大小 8192，1个线程
auto async_file = spdlog::basic_logger_mt("async_file", "logs/async.log");
async_file->info("这条日志异步写入，不影响主线程");

注意：使用异步日志前必须调用 init_thread_pool。

6. 自定义日志格式

spdlog 允许自定义日志格式。例如：

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

其中：

• %Y-%m-%d：年-月-日
• %H:%M:%S.%e：时:分:秒.毫秒
• %n：logger 名称
• %l：日志级别
• %v：日志内容

也可以为特定 logger 设置格式：

file_logger->set_pattern("[%H:%M:%S] %v");

7. 最佳实践建议

• 在程序启动时统一配置日志系统，避免分散设置
• 使用命名 logger 区分模块，如 "net", "db", "ui"
• 生产环境启用异步日志以减少 I/O 阻塞
• 合理设置日志级别，避免过度输出
• 定期轮转日志文件（可结合 rotating_file_sink）

基本上就这些。spdlog 功能强大且使用直观，能显著提升 C++ 项目的可观测性。只要引入头文件并简单配置，就能拥有工业级的日志能力。不复杂但容易忽略的是线程安全和性能影响，推荐优先使用异步模式处理高频日志。