从 0 到 1 实现高性能日志库 MiniSpdlog — 这可能是最适合新手的日志系统实战项目 !

news/2025/10/14 20:56:42/文章来源:https://www.cnblogs.com/xiaokang-coding/p/19142003

嘿，各位C++er们！我是小康 👋

今天我们来聊一个每个开发者都绕不开的话题——日志记录。

你是不是还在用最原始的 cout 和 printf 调试代码？是不是因为线上程序出问题找不到日志而抓狂？别急，今天我就来给大家盘点一下C++界那些大名鼎鼎的日志库，看看哪个最适合你的项目！

为什么需要专业的日志库？

在深入介绍各种日志库之前，先说说为什么我们需要专业的日志库：

专业需求

性能要求：生产环境下，日志不能影响主业务性能
线程安全：多线程环境下确保日志不会乱序或丢失
格式控制：统一的日志格式，便于后续分析
文件管理：自动切分、压缩、清理过期日志
级别控制：根据环境动态调整日志级别

如果你还在用 cout 打日志，说明你还没体验过专业日志库的魅力！接下来，让我们看看C++界都有哪些"明星选手"。

🏆 第一梯队：业界标杆级日志库

1. spdlog - 当之无愧的性能之王

spdlog 是一个快速的、仅头文件的 C++ 日志库，使用 fmt 库进行格式化，支持多种输出方式。

核心特点：

超快的性能（详见基准测试）
支持同步和异步日志
丰富的格式化功能，使用优秀的 fmt 库
多线程和单线程日志器
文件滚动、每日日志文件
控制台日志（支持颜色）

使用示例：

#include "spdlog/spdlog.h"int main() {spdlog::info("欢迎使用 spdlog!");spdlog::error("出错了: {}", 42);spdlog::warn("格式化很简单: {:03.2f}", 1.23456);
}

性能表现： 在基准测试中，spdlog 在平均情况下表现出色，但在最坏情况延迟方面需要权衡。

适用场景：

高性能应用
需要异步日志的系统
对格式化要求较高的项目

2. glog - 谷歌出品，必属精品

glog 是 Google 日志模块的 C++ 实现。

核心特点：

Google 出品，稳定可靠
简单易用，依赖少
自动crash处理和stack trace
支持不同严重级别的日志
在独立应用中表现优秀

使用示例：

#include <glog/logging.h>int main(int argc, char* argv[]) {google::InitGoogleLogging(argv[0]);LOG(INFO) << "这是一条信息日志";LOG(WARNING) << "警告: " << 42;LOG(ERROR) << "错误发生了!";return 0;
}

注意事项: glog 只能初始化一次，如果在库中使用需要考虑配置问题。

适用场景：

Google 技术栈项目
需要稳定性的企业级应用
单体应用程序

3. Boost.Log - 功能最强大的重型武器

Boost.Log 设计得非常模块化和可扩展。

核心特点：

功能极其丰富
高度可定制化
支持复杂的过滤和格式化
更像是构建自己日志库的框架

使用示例：

#include <boost/log/trivial.hpp>int main() {BOOST_LOG_TRIVIAL(info) << "这是一个测试 " << 123;return 0;
}

⚠️ 注意事项： 文档量巨大，学习曲线陡峭。

适用场景：

复杂的企业级系统
需要高度定制化的项目
对功能要求极高的场景

🥈 第二梯队：各有特色的专业选手

4. log4cpp - 经典的Java Log4j移植版

Log4cpp 是一个 C++ 类库，用于灵活地记录日志到文件、syslog 和其他目的地，它模仿了 Java 的 Log4j 库。

核心特点：

成熟稳定（2024年8月还在更新）
支持多种输出目标（文件、syslog、IDSA 等）
配置灵活
线程安全，支持灵活和任意粒度的日志管理控制

使用示例：

#include "log4cpp/Category.hh"
#include "log4cpp/Appender.hh"
#include "log4cpp/FileAppender.hh"
#include "log4cpp/Layout.hh"
#include "log4cpp/BasicLayout.hh"int main() {log4cpp::Category& root = log4cpp::Category::getRoot();root.setPriority(log4cpp::Priority::WARN);log4cpp::Category& sub1 = log4cpp::Category::getInstance("sub1");sub1.info("这是一条信息日志");sub1.warn("警告日志");
}

适用场景：

传统企业项目
需要与Java系统保持一致的日志格式
对稳定性要求高的系统

5. plog - 轻量级的简洁选择

plog 是一个可移植且简单的 C++ 日志库，代码少于1000行。

核心特点：

代码量极少（<1000行）
头文件库，易集成
可移植、简单且可扩展
轻量级但功能完整

使用示例：

#include <plog/Log.h>
#include <plog/Initializers/RollingFileInitializer.h>int main() {plog::init(plog::debug, "app.log"); // 初始化日志PLOGD << "这是调试信息";PLOGI << "程序启动成功";PLOGW << "这是警告: " << 42;PLOGE << "发生错误!";
}

适用场景：

小型项目
需要快速集成的场景
对库大小敏感的项目

6. fmtlog - 纳秒级延迟的性能怪兽

fmtlog 是一个高性能的 fmtlib 风格的日志库，延迟达到纳秒级。

核心特点：

纳秒级延迟性能
使用 fmtlib 风格的API
专为高频日志场景优化

使用示例：

#include "fmtlog/fmtlog.h"int main() {fmtlog::setLogFile("app.log");logd("这是调试信息: {}", 42);logi("程序启动成功");logw("警告: 数值 = {:.2f}", 3.14159);loge("错误发生: {}", "内存不足");fmtlog::poll(); // 处理异步日志return 0;
}

适用场景：

高频交易系统
实时性要求极高的应用
对延迟敏感的系统

7. G3log - 异步安全的可靠选择

G3log 是带有动态 Sink 的异步日志器。

核心特点：

异步且"崩溃安全"的日志器
可以捕获致命事件如段错误
动态Sink支持
专为稳定性设计

使用示例：

#include <g3log/g3log.hpp>
#include <g3log/logworker.hpp>int main() {auto worker = g3::LogWorker::createLogWorker();auto handle= worker->addDefaultLogger("app", "./");g3::initializeLogging(worker.get());LOG(INFO) << "程序启动";LOG(WARNING) << "这是警告: " << 123;LOG(FATAL) << "严重错误"; // 会触发程序终止
}

适用场景：