C++ 日志庫(kù)log4cpp使用詳解

更新時(shí)間：2026年01月29日 10:02:36 作者：bkspiderx

log4cpp是基于log4j設(shè)計(jì)的開(kāi)源日志庫(kù),包括日志級(jí)別控制、多種輸出目的地、日志格式自定義等,本文介紹了C++日志庫(kù)log4cpp的核心概念與使用方法,感興趣的可以了解一下

log4cpp 是一個(gè)基于 C++ 的開(kāi)源日志庫(kù)，靈感來(lái)源于 Java 的 log4j，提供了靈活的日志管理功能，包括日志級(jí)別控制、多種輸出目的地、日志格式自定義等。它特別適合中大型 C++ 項(xiàng)目，能夠滿足復(fù)雜的日志需求。本文將詳細(xì)介紹 log4cpp 的核心概念、使用方法和最佳實(shí)踐。

一、log4cpp 核心概念

在使用 log4cpp 之前，需要了解幾個(gè)核心組件：

Category（日志類(lèi)別）：用于區(qū)分不同模塊的日志，類(lèi)似日志的"命名空間"，可以通過(guò)層次結(jié)構(gòu)組織（如 root.category、root.category.net）。
Appender（輸出器）：定義日志的輸出目的地，如控制臺(tái)、文件、網(wǎng)絡(luò)等，一個(gè) Category 可以關(guān)聯(lián)多個(gè) Appender。
Layout（布局）：控制日志的輸出格式，如是否包含時(shí)間、日志級(jí)別、文件名、行號(hào)等信息。
Priority（優(yōu)先級(jí)）：日志級(jí)別，從高到低為：FATAL、ALERT、CRIT、ERROR、WARN、NOTICE、INFO、DEBUG。

二、安裝 log4cpp

1. Linux 系統(tǒng)安裝

# Ubuntu/Debian
sudo apt-get install liblog4cpp5-dev

# CentOS/RHEL（需先配置 EPEL 源）
sudo yum install log4cpp-devel

2. 源碼編譯安裝

# 下載源碼
wget https://downloads.sourceforge.net/project/log4cpp/log4cpp-1.1.x%20%28new%29/log4cpp-1.1.3/log4cpp-1.1.3.tar.gz
tar zxvf log4cpp-1.1.3.tar.gz
cd log4cpp-1.1.3

# 編譯安裝
./configure --prefix=/usr/local
make
sudo make install

三、log4cpp 基本使用示例

下面是一個(gè)包含函數(shù)名、行號(hào)等信息的 log4cpp 入門(mén)示例：

#include <log4cpp/Category.hh>
#include <log4cpp/PropertyConfigurator.hh>
#include <log4cpp/Appender.hh>
#include <log4cpp/FileAppender.hh>
#include <log4cpp/OstreamAppender.hh>
#include <log4cpp/Layout.hh>
#include <log4cpp/PatternLayout.hh>
#include <log4cpp/Priority.hh>

// 定義日志宏，自動(dòng)添加文件名、函數(shù)名和行號(hào)
#define LOG_DEBUG(msg) \
    log4cpp::Category::getRoot() << log4cpp::Priority::DEBUG << "[" << __FILE__ << ":" << __LINE__ << "] " << __func__ << ": " << msg

#define LOG_INFO(msg) \
    log4cpp::Category::getRoot() << log4cpp::Priority::INFO << "[" << __FILE__ << ":" << __LINE__ << "] " << __func__ << ": " << msg

#define LOG_WARN(msg) \
    log4cpp::Category::getRoot() << log4cpp::Priority::WARN << "[" << __FILE__ << ":" << __LINE__ << "] " << __func__ << ": " << msg

#define LOG_ERROR(msg) \
    log4cpp::Category::getRoot() << log4cpp::Priority::ERROR << "[" << __FILE__ << ":" << __LINE__ << "] " << __func__ << ": " << msg

#define LOG_FATAL(msg) \
    log4cpp::Category::getRoot() << log4cpp::Priority::FATAL << "[" << __FILE__ << ":" << __LINE__ << "] " << __func__ << ": " << msg

// 帶格式化輸出的日志宏
#define LOG_DEBUG_F(fmt, ...) \
    do { \
        char buffer[1024]; \
        snprintf(buffer, sizeof(buffer), fmt, ##__VA_ARGS__); \
        LOG_DEBUG(buffer); \
    } while(0)

#define LOG_INFO_F(fmt, ...) \
    do { \
        char buffer[1024]; \
        snprintf(buffer, sizeof(buffer), fmt, ##__VA_ARGS__); \
        LOG_INFO(buffer); \
    } while(0)

// 初始化日志配置
void initLog() {
    // 創(chuàng)建控制臺(tái)輸出器
    log4cpp::Appender* consoleAppender = new log4cpp::OstreamAppender("console", &std::cout);
    
    // 創(chuàng)建文件輸出器
    log4cpp::Appender* fileAppender = new log4cpp::FileAppender("file", "app.log");
    
    // 創(chuàng)建布局，設(shè)置日志格式
    log4cpp::PatternLayout* layout = new log4cpp::PatternLayout();
    // 格式說(shuō)明：%d-日期 %p-優(yōu)先級(jí) %c-類(lèi)別 %m-消息 %n-換行
    layout->setConversionPattern("%d{%Y-%m-%d %H:%M:%S} %p %c %m%n");
    
    // 為輸出器設(shè)置布局
    consoleAppender->setLayout(layout);
    fileAppender->setLayout(layout);
    
    // 獲取根日志類(lèi)別，并添加輸出器
    log4cpp::Category& root = log4cpp::Category::getRoot();
    root.addAppender(consoleAppender);
    root.addAppender(fileAppender);
    
    // 設(shè)置根日志的優(yōu)先級(jí)（低于此級(jí)別的日志不輸出）
    root.setPriority(log4cpp::Priority::DEBUG);
}

// 測(cè)試函數(shù)
void testLogFunction(int value) {
    LOG_DEBUG("進(jìn)入測(cè)試函數(shù)");
    LOG_INFO_F("參數(shù)值為: %d", value);
    
    if (value < 0) {
        LOG_WARN("參數(shù)值為負(fù)數(shù)");
    }
    
    if (value == 0) {
        LOG_ERROR("參數(shù)值不能為零");
    }
}

int main() {
    // 初始化日志
    initLog();
    
    LOG_INFO("程序啟動(dòng)");
    
    // 測(cè)試日志輸出
    testLogFunction(10);
    testLogFunction(-5);
    testLogFunction(0);
    
    LOG_INFO("程序退出");
    
    // 清理日志資源
    log4cpp::Category::shutdown();
    return 0;
}

編譯與運(yùn)行

編譯時(shí)需要鏈接 log4cpp 庫(kù)：

g++ log4cpp_demo.cpp -o log_demo -llog4cpp -lpthread
./log_demo

運(yùn)行后會(huì)生成 app.log 文件，同時(shí)在控制臺(tái)輸出日志，典型輸出如下：

2024-09-15 10:30:00 INFO root [log4cpp_demo.cpp:66] main: 程序啟動(dòng)
2024-09-15 10:30:00 DEBUG root [log4cpp_demo.cpp:59] testLogFunction: 進(jìn)入測(cè)試函數(shù)
2024-09-15 10:30:00 INFO root [log4cpp_demo.cpp:60] testLogFunction: 參數(shù)值為: 10
2024-09-15 10:30:00 DEBUG root [log4cpp_demo.cpp:59] testLogFunction: 進(jìn)入測(cè)試函數(shù)
2024-09-15 10:30:00 INFO root [log4cpp_demo.cpp:60] testLogFunction: 參數(shù)值為: -5
2024-09-15 10:30:00 WARN root [log4cpp_demo.cpp:62] testLogFunction: 參數(shù)值為負(fù)數(shù)
2024-09-15 10:30:00 DEBUG root [log4cpp_demo.cpp:59] testLogFunction: 進(jìn)入測(cè)試函數(shù)
2024-09-15 10:30:00 INFO root [log4cpp_demo.cpp:60] testLogFunction: 參數(shù)值為: 0
2024-09-15 10:30:00 ERROR root [log4cpp_demo.cpp:65] testLogFunction: 參數(shù)值不能為零
2024-09-15 10:30:00 INFO root [log4cpp_demo.cpp:70] main: 程序退出

四、通過(guò)配置文件使用 log4cpp

對(duì)于復(fù)雜項(xiàng)目，推薦使用配置文件來(lái)管理 log4cpp 配置，這樣可以在不修改代碼的情況下調(diào)整日志行為。

1. 配置文件（log4cpp.properties）

# 根日志類(lèi)別設(shè)置
log4cpp.rootCategory=DEBUG, console, file

# 控制臺(tái)輸出器配置
log4cpp.appender.console=org.apache.log4j.ConsoleAppender
log4cpp.appender.console.layout=org.apache.log4j.PatternLayout
log4cpp.appender.console.layout.ConversionPattern=%d{%Y-%m-%d %H:%M:%S} %p %c %m%n

# 文件輸出器配置
log4cpp.appender.file=org.apache.log4j.FileAppender
log4cpp.appender.file.fileName=app.log
log4cpp.appender.file.layout=org.apache.log4j.PatternLayout
log4cpp.appender.file.layout.ConversionPattern=%d{%Y-%m-%d %H:%M:%S} %p %c [%-20F:%-4L] %-20M %m%n

# 模塊特定日志配置（例如網(wǎng)絡(luò)模塊）
log4cpp.category.net=INFO, netfile
log4cpp.additivity.net=false
log4cpp.appender.netfile=org.apache.log4j.FileAppender
log4cpp.appender.netfile.fileName=net.log
log4cpp.appender.netfile.layout=org.apache.log4j.PatternLayout
log4cpp.appender.netfile.layout.ConversionPattern=%d %p %m%n

2. 使用配置文件的代碼

#include <log4cpp/Category.hh>
#include <log4cpp/PropertyConfigurator.hh>

// 日志宏定義（同上）
// ...

int main() {
    try {
        // 通過(guò)配置文件初始化
        log4cpp::PropertyConfigurator::configure("log4cpp.properties");
    } catch (log4cpp::ConfigureFailure& f) {
        std::cerr << "配置文件加載失敗: " << f.what() << std::endl;
        return 1;
    }
    
    // 獲取根日志類(lèi)別
    log4cpp::Category& root = log4cpp::Category::getRoot();
    root.info("程序啟動(dòng)");
    
    // 獲取網(wǎng)絡(luò)模塊日志類(lèi)別
    log4cpp::Category& netCat = log4cpp::Category::getInstance("net");
    netCat.info("網(wǎng)絡(luò)連接建立");
    
    // ... 其他日志輸出
    
    log4cpp::Category::shutdown();
    return 0;
}

五、log4cpp 高級(jí)特性

1. 日志滾動(dòng)（RollingFileAppender）

當(dāng)日志文件達(dá)到一定大小后自動(dòng)創(chuàng)建新文件：

// 在代碼中配置
log4cpp::RollingFileAppender* rollingAppender = 
    new log4cpp::RollingFileAppender("rolling", "rolling.log", 1024*1024, 5); // 1MB 每個(gè)，最多 5 個(gè)文件

或在配置文件中：

log4cpp.appender.rolling=org.apache.log4j.RollingFileAppender
log4cpp.appender.rolling.fileName=rolling.log
log4cpp.appender.rolling.maxFileSize=1048576
log4cpp.appender.rolling.maxBackupIndex=5

2. 每日滾動(dòng)日志（DailyRollingFileAppender）

按時(shí)間自動(dòng)切割日志（如每天生成一個(gè)新日志文件）：

log4cpp.appender.daily=org.apache.log4j.DailyRollingFileAppender
log4cpp.appender.daily.fileName=daily.log
log4cpp.appender.daily.datePattern='.'yyyy-MM-dd

3. 日志級(jí)別控制

可以為不同的日志類(lèi)別設(shè)置不同的級(jí)別，例如開(kāi)發(fā)環(huán)境輸出 DEBUG 級(jí)別，生產(chǎn)環(huán)境只輸出 INFO 及以上級(jí)別：

// 代碼中設(shè)置
log4cpp::Category::getRoot().setPriority(log4cpp::Priority::INFO);
log4cpp::Category::getInstance("debug.module").setPriority(log4cpp::Priority::DEBUG);

六、最佳實(shí)踐

使用宏封裝日志調(diào)用：如示例中定義的 LOG_DEBUG、LOG_INFO 等宏，自動(dòng)添加文件名、函數(shù)名和行號(hào)信息。
合理設(shè)置日志級(jí)別：
- DEBUG：開(kāi)發(fā)調(diào)試信息，生產(chǎn)環(huán)境通常關(guān)閉
- INFO：正常運(yùn)行狀態(tài)信息
- WARN：需要注意的異常情況，但不影響程序運(yùn)行
- ERROR：錯(cuò)誤信息，可能影響部分功能
- FATAL：致命錯(cuò)誤，程序可能無(wú)法繼續(xù)運(yùn)行
按模塊劃分日志類(lèi)別：如 net、db、ui 等，便于日志過(guò)濾和分析。
避免在日志中輸出敏感信息：如密碼、個(gè)人信息等。
注意日志性能：
- 避免在高頻調(diào)用的函數(shù)中輸出大量 DEBUG 日志
- 復(fù)雜格式化操作可以先判斷日志級(jí)別再執(zhí)行
及時(shí)清理日志：配置日志滾動(dòng)或定時(shí)清理機(jī)制，避免磁盤(pán)空間耗盡。

七、總結(jié)

log4cpp 提供了靈活而強(qiáng)大的日志功能，通過(guò)合理配置可以滿足各種復(fù)雜的日志需求。它的核心優(yōu)勢(shì)在于：

支持多種日志輸出目的地（控制臺(tái)、文件、網(wǎng)絡(luò)等）
可自定義日志格式，輕松添加函數(shù)名、行號(hào)等上下文信息
支持日志級(jí)別控制，便于在不同環(huán)境下調(diào)整日志詳細(xì)程度
支持日志滾動(dòng)，方便日志管理和歸檔

掌握 log4cpp 的使用，能夠顯著提升 C++ 項(xiàng)目的調(diào)試效率和運(yùn)維能力。在實(shí)際項(xiàng)目中，建議結(jié)合配置文件使用，以便在不修改代碼的情況下靈活調(diào)整日志策略。

到此這篇關(guān)于C++ 日志庫(kù)log4cpp使用詳解的文章就介紹到這了,更多相關(guān)C++ 日志庫(kù)log4cpp內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

C++?Log4cpp跨平臺(tái)日志庫(kù)的使用小結(jié)

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

C++ 日志庫(kù)log4cpp使用詳解

目錄

一、log4cpp 核心概念

二、安裝 log4cpp

1. Linux 系統(tǒng)安裝

2. 源碼編譯安裝

三、log4cpp 基本使用示例

編譯與運(yùn)行

四、通過(guò)配置文件使用 log4cpp

1. 配置文件（log4cpp.properties）

2. 使用配置文件的代碼

五、log4cpp 高級(jí)特性

1. 日志滾動(dòng)（RollingFileAppender）

2. 每日滾動(dòng)日志（DailyRollingFileAppender）

3. 日志級(jí)別控制

六、最佳實(shí)踐

七、總結(jié)

相關(guān)文章

最新評(píng)論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

最新国产好看的视频,伊人天堂AV在线,国产Aaaaaa视频,蜜臀视频在线观看一区,人妻av色图,密臀久久久精品影片,青青视频免费观看毛片,久草在线观看视,国产三级精品色情在线

C++ 日志庫(kù)log4cpp使用詳解

目錄

一、log4cpp 核心概念

二、安裝 log4cpp

1. Linux 系統(tǒng)安裝

2. 源碼編譯安裝

三、log4cpp 基本使用示例

編譯與運(yùn)行

四、通過(guò)配置文件使用 log4cpp

1. 配置文件（log4cpp.properties）

2. 使用配置文件的代碼

五、log4cpp 高級(jí)特性

1. 日志滾動(dòng)（RollingFileAppender）

2. 每日滾動(dòng)日志（DailyRollingFileAppender）

3. 日志級(jí)別控制

六、最佳實(shí)踐

七、總結(jié)

相關(guān)文章

最新評(píng)論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

一、log4cpp 核心概念

三、log4cpp 基本使用示例

五、log4cpp 高級(jí)特性

七、總結(jié)