[C/C++] 如何实现C++日志文件大小限制与循环保存？spdlog使用详解

在C++项目开发中，打印日志是软件工程师进行调试和问题追踪的必备技能。然而，单纯使用 printf 或 std::cout 输出日志往往不够优雅，缺乏结构化、异步、分级存储等高级特性。

本文将介绍一个在C++社区中备受推崇的、设计优雅的开源日志库：spdlog。其GitHub仓库地址为： https://github.com/gabime/spdlog 。

为了便于大家快速理解，我基于该仓库编写了一个简单的测试Demo，代码已托管在 Gitee： https://gitee.com/weiqifa/spdlog/blob/master/main.cpp 。

编译并运行示例程序，可以得到格式清晰、带有时间戳和日志等级的的输出：

[2026-01-04 20:02:11.272] [info] Hello, spdlog! 这是控制台日志
[2026-01-04 20:02:11.272] [warning] 警告信息: 123
[2026-01-04 20:02:11.272] [error] 错误信息

一个健壮的日志模块，其核心需求之一便是有效的存储管理。尤其在存储空间有限的嵌入式或服务器环境中，我们必须具备循环保存日志的机制，确保在持续记录的同时，不会因日志文件无限增长而占满磁盘空间。

spdlog 的另一个突出优点是易于集成。它主要以头文件库的形式提供，能够快速嵌入到现有项目中。下面的示例代码便展示了如何包含头文件并使用其强大的文件轮转（Rotating File）功能，这正是实现日志文件大小限制与循环保存的关键。如果你对 C/C++ 项目中的依赖管理有更多兴趣，可以深入探讨。

如上图所示，这段代码通过 spdlog::rotating_logger_mt 创建了一个日志记录器，其核心参数 MAX_FILE_SIZE 设置了单个日志文件的大小上限（示例中为 1MB）。当日志文件达到此限制时，spdlog 会自动进行轮转，完美满足了控制日志体积、防止磁盘写满的刚性需求。这种对日志生命周期的精细控制，体现了 开源实战 中优秀库的设计哲学。

总的来说，spdlog 以其高性能、易用性和丰富的特性（如异步日志、多种格式化输出、多接收器支持等），成为 C++ 开发者处理日志需求的一个“比较不错”甚至堪称优秀的选择。想了解更多类似的实用工具和开发技巧，欢迎访问 云栈社区 与其他开发者交流分享。