Log4CPlus 用户手册 笔记

Log4CPlus 用户手册

log4cplus 是一款受 log4j 启发的 C++ 日志库,提供线程安全且可配置的日志功能。它支持日志级别、输出目的地(appenders)以及格式化布局(layouts)。安装可通过 apt-get 等包管理器完成,也可从源码构建。该库 2.x 版本需要 C++11,最新 3.x 系列需要 C++23。与 CMake 项目的集成可通过 Conan 等包管理器实现。一个最小示例展示了基本初始化、创建 logger 以及记录消息。BasicConfigurator 为控制台日志提供简单的默认配置。对于实际项目,推荐使用 PropertyConfigurator 通过属性文件配置 logger。日志级别从 TRACE 到 FATAL,ALL 和 OFF 作为伪级别用于过滤。常见的 appenders 包括 ConsoleAppender、FileAppender 和 RollingFileAppender。CallbackAppender 允许将日志事件路由到自定义的 C 风格函数。Appenders 默认同步运行,但可启用异步操作以提升性能。程序退出时调用 log4cplus::Logger::shutdown() 可实现干净关闭。