log4cplus最新介绍、详细编译过程及使用(最全面)

雪夜
2025-08-12
热度

一、log4cplus概述

log4cplus是一个用C++编写的开源日志系统，它起源于Java的log4j系统，并受Apache软件许可证保护，由Tad E. Smith开发。

log4cplus具备线程安全、灵活性和多级控制等特点，通过将日志划分为不同的优先级，使其适用于程序的调试、运行、测试和维护等全生命周期。用户可以选择将日志输出到屏幕、文件、NT事件日志，甚至是远程服务器；此外，还可以通过指定策略对日志进行定期备份等操作。

二、log4cplus下载

下载链接：https://www.php.cn/link/1b3ecca102b57d735ac385a9c03fd15b

最新稳定版为2.0.8（发布于2022年8月15日）

官方文档：https://www.php.cn/link/22f266a9987440c2fcba09a845b638b1

GitHub地址：https://www.php.cn/link/0bf4193e64622cc35e7af3715e30f1d6

国内镜像地址：mirrors / log4cplus / log4cplus · GitCode

最新版本可能需要C++2017标准（但实际上，经测试使用Visual Studio 2015可以编译2.0.8版本。官方表示3.0以后的版本才需要C++2017），这里也提供一个低版本的，支持C++11的tag版本：GitHub - log4cplus/log4cplus at REL_2_0_4

三、编译生成库

在Linux上编译相对简单一些。

解压：

gzip -cd log4cplus-x.x.x.tar.gz | tar -xf -

进入log4cplus根目录：
```
cd log4cplus-x.x.x
```

生成Makefile：

./configure --prefix=/where/to/install --enable-threads=no

如果需要指定安装路径，可以使用

--prefix

参数，否则默认安装到

/usr/local

目录下。此外，如果需要单线程版本，可以通过参数

--enable-threads=no

指定，否则默认将安装多线程版本。

需要注意的是，

--enable-static

参数是用来编译静态库的选项，默认是关闭的。如果需要静态库，需要开启此选项。

在Windows上编译则稍微复杂一些。

可以选择的编译方式有：Visual Studio，CMake，vcpkg等。其中使用vcpkg是最简单便捷的。

方式一、使用Visual Studio环境编译

在Windows上，主要的构建系统是Visual Studio 2015解决方案和项目（

msvc14/log4cplus.sln

）。

如果有Windows下的Visual Studio环境，可以打开Visual Studio，进入log4cplus-2.x\msvc14目录下，运行log4cplus.sln解决方案。

选择log4cplus项目，属性中设置字符集和目标程序一致。右键->属性->配置属性->常规->字符集，选择Unicode字符集。
解决方案的平台应与目标程序一致，这里选择x64。
版本也应与目标程序一致，这里选择release版本。

编译完成后，将在log4cplus-2.x\msvc14\x64\bin.Release文件夹下生成我们需要的log4cplus.lib和log4cplus.dll两个文件。

将log4cplus-2.0.x目录下的include文件夹复制到我们的目标程序文件夹中，这里是我们需要的头文件。

简单的测试：

#include 
#include 
#include 
int main() {
// 初始化
log4cplus::Initializer initializer;
log4cplus::BasicConfigurator config;
config.configure();
log4cplus::Logger logger = log4cplus::Logger::getInstance(LOG4CPLUS_TEXT("main"));
LOG4CPLUS_WARN(logger, LOG4CPLUS_TEXT("Hello, World!"));

system("pause");
return 0;
}
异步模式需要开启，否则多线程同时写日志可能会出现问题。
以下是旧版本才需要的操作。
对于旧版本，需要从https://github.com/log4cplus/ThreadPool下载.h和.cpp文件，并放到\log4cplus\log4cplus-REL_2_0_4\threadpool目录下。
Catch-master下载：Catch-master.zip，解压后，将文件夹中的内容复制到log4cplus-REL_2_0_4\catch中。
新版本无需这些操作，因为新版源码中已经包含了这些文件。
方式二、使用vcpkg安装依赖包

使用vcpkg工具
安装匹配项目的包（64位的使用:x64-windows）：
vcpkg install log4cplus[core, unicode]:x86-windows


方式三、使用CMake环境编译
在下载的源码根目录下创建一个build_msvc文件夹，进入该文件夹，执行：
log4cplus-2.0.8\build_msvc> cmake ../
 vc的工程