Linux中C++怎样进行日志记录

在Linux环境下做C++开发，日志记录这件事几乎是绕不开的。不管是为了调试问题、追踪运行状态，还是生产环境下的故障排查，一套靠谱的日志系统都是刚需。那么，具体有哪些实现方式？从最基础的“手写”方案到成熟的第三方库，下面逐一拆解，并分享一些在实际项目中积累下来的经验。

1. 使用标准库进行基本日志记录

C++标准库本身并没有专门提供日志功能，但借助I/O流（比如 std::ofstream），自己动手写一个简单的日志记录器并不难。对于小工具或临时脚本来说，这种方式足够轻量，不需要引入额外依赖。

示例代码

#include 
#include 
#include 
#include 

// 获取当前时间字符串
std::string getCurrentTime() {
    std::time_t t = std::time(nullptr);
    char buf[80];
    if (std::strftime(buf, sizeof(buf), "%Y-%m-%d %H:%M:%S", std::localtime(&t))) {
        return std::string(buf);
    }
    return "";
}

// 日志记录函数
void logMessage(const std::string& filename, const std::string& message) {
    std::ofstream logFile(filename, std::ios::app); // 以追加模式打开文件
    if (!logFile.is_open()) {
        std::cerr << "无法打开日志文件: " << filename << std::endl;
        return;
    }
    logFile << getCurrentTime() << " - " << message << std::endl;
    logFile.close();
}

int main() {
    logMessage("app.log", "程序启动");
    // ... 程序逻辑 ...
    logMessage("app.log", "程序结束");
    return 0;
}

说明

• 时间戳：getCurrentTime 函数负责获取当前日期和时间，让每条日志都能知道“什么时候发生的”。
• 日志文件：logMessage 函数以追加模式写入指定文件（比如 app.log），避免覆盖历史记录。
• 错误处理：如果文件打不开，直接通过标准错误流输出提示，不至于让程序悄无声息地丢掉日志。

这种方式的优点是零依赖、代码直观，但缺点也很明显——没有日志级别、没有轮转、没有格式化控制，更别提多线程安全了。一旦项目规模上去，这套方案很快就会捉襟见肘。

2. 使用第三方日志库

如果想省心省力，直接上成熟的第三方库是最明智的选择。下面介绍三个在C++社区里口碑不错的日志库，各有侧重，可以根据实际场景来选。

a. spdlog

spdlog 是目前最流行的C++日志库之一，特点是速度快、使用简单、功能丰富。它支持多线程、异步日志、多种日志级别，并且有非常漂亮的格式化语法。如果你刚接触C++日志库，从 spdlog 入手基本不会踩坑。

安装

以Ubuntu为例，通过包管理器安装是最省事的：

sudo apt-get install libspdlog-dev

当然，也可以从GitHub克隆源码自行编译：

git clone https://github.com/gabime/spdlog.git
cd spdlog
mkdir build && cd build
cmake ..
make -j$(nproc)
sudo make install

示例代码

#include "spdlog/spdlog.h"
#include "spdlog/sinks/basic_file_sink.h"

int main() {
    // 创建一个基本文件日志记录器，日志文件名为logs/basic.txt
    auto logger = spdlog::basic_logger_mt("basic_logger", "logs/basic.txt");
    // 设置日志级别
    logger->set_level(spdlog::level::info);
    // 记录不同级别的日志
    logger->trace("这是一条trace日志");
    logger->debug("这是一条debug日志");
    logger->info("这是一条info日志");
    logger->warn("这是一条warn日志");
    logger->error("这是一条error日志");
    logger->critical("这是一条critical日志");
    // 记录带有格式的日志
    logger->info("欢迎 {} 加入日志系统！", "C++开发者");
    return 0;
}

编译

编译时记得链接 spdlog 库：

g++ -std=c++11 your_code.cpp -o your_program -lspdlog

spdlog 的 API 设计非常现代，格式化输出直接支持占位符，跟 Python 的 format 类似，写起来很顺手。

b. log4cpp

log4cpp 是受 Ja va 的 log4j 启发而诞生的，架构上比较传统，但胜在稳定和成熟。它支持多种输出目的地（文件、控制台、网络等），并且有灵活的布局配置。如果你曾经用过 log4j，上手 log4cpp 几乎零成本。

安装

sudo apt-get install liblog4cpp5-dev

示例代码

#include 
#include 
#include 
#include 

int main() {
    // 创建一个布局
    log4cpp::BasicLayout* layout = new log4cpp::BasicLayout();
    // 创建一个文件追加器并设置布局
    log4cpp::FileAppender* fileAppender = new log4cpp::FileAppender("default", "application.log");
    fileAppender->setLayout(layout);
    // 创建一个类别并添加追加器
    log4cpp::Category& root = log4cpp::Category::getRoot();
    root.addAppender(fileAppender);
    root.setPriority(log4cpp::Priority::INFO);
    // 记录日志
    root.info("程序启动");
    // ... 程序逻辑 ...
    root.info("程序结束");
    // 清理资源
    delete fileAppender;
    delete layout;
    return 0;
}

编译

g++ -std=c++11 your_code.cpp -o your_program `pkg-config --cflags --libs log4cpp`

log4cpp 的代码风格偏“老派”，需要手动管理指针和布局对象，但很多老项目里依然在用，如果你的团队对 log4j 体系熟悉，选它也没什么问题。

c. Boost.Log

Boost.Log 是 Boost 库大家族的一员，功能极其强大，从日志格式、过滤器、异步写入到文件轮转，几乎可以定制一切。当然，代价是编译复杂度和学习曲线都比较高——毕竟 Boost 的“重量级”名声不是白来的。

安装

sudo apt-get install libboost-all-dev

示例代码

#include 
#include 
#include 
#include 
#include 

namespace logging = boost::log;
namespace src = boost::log::sources;
namespace sinks = boost::log::sinks;
namespace expr = boost::log::expressions;

void init_logging() {
    // 创建一个文本文件后端
    typedef sinks::text_file_backend<
        sinks::file::rotation_size<10*1024*1024>, // 每10MB旋转一次
        sinks::file::time_based_rotation< sinks::file::rotation_at_time_point(0,0,0) >
    > file_backend_t;
    // 创建一个格式化器
    typedef sinks::synchronous_sink sink_t;
    boost::shared_ptr backend(new file_backend_t);
    boost::shared_ptr sink(new sink_t(backend));
    // 设置日志格式
    sink->set_formatter(expr::stream<<
        "[" << expr::format_date_time("TimeStamp", "%Y-%m-%d %H:%M:%S") << "] "
        << expr::smessage);
    // 添加到核心
    logging::core::get()->add_sink(sink);
    // 设置全局日志级别
    logging::core::get()->set_filter(logging::trivial::severity >= logging::trivial::info);
    // 添加控制台日志
    logging::add_console_log(std::cout,
        keywords::format = "[%TimeStamp%]: %Message%");
}

int main() {
    init_logging();
    BOOST_LOG_TRIVIAL(info) << "程序启动";
    // ... 程序逻辑 ...
    BOOST_LOG_TRIVIAL(info) << "程序结束";
    return 0;
}

编译

g++ -std=c++11 your_code.cpp -o your_program -lboost_log -lboost_system -lboost_thread

Boost.Log 的配置显得繁琐，但好处是几乎不需要额外工作就能实现生产级日志系统——文件轮转、异步、多线程安全全都有，且性能稳定。

3. 日志记录的最佳实践

工具选好了，但怎么用才能让日志系统真正帮上忙？下面这几条经验，可以说是在多个项目里验证过的“通用法则”。

a. 日志级别

合理定义 DEBUG、INFO、WARN、ERROR、FATAL 等级别，并在开发阶段和生产环境分别设置不同的输出阈值。生产环境通常只记录 INFO 及以上，避免海量调试信息把磁盘撑爆；而排查问题的时候，临时把级别调到 DEBUG 又能快速定位。

b. 日志格式

统一的格式是日志可读性的基础。通常建议包含：时间戳、日志级别、线程ID、模块名称，以及日志消息。这样无论是人眼扫读，还是用工具（如 grep、logstash）解析，都很方便。

c. 日志轮转

一个日志文件无限增长？那基本等于灾难。好的做法是设定大小阈值（比如10MB）或时间周期（每天凌晨轮转），自动创建新文件并保留历史。大多数日志库都内置了轮转功能，直接配置即可。

d. 异步日志

对于高性能应用，如果每次写日志都同步等待磁盘I/O，程序性能会明显下降。异步日志将日志写入操作丢到后台线程，主线程只管出队消息，几乎不影响业务逻辑的吞吐量。spdlog 和 Boost.Log 都支持异步模式，需要时开启就好。

e. 日志输出目的地

不要只拘泥于文件。有时候错误信息直接输出到控制台，或者通过网络发送到集中的日志服务器，反而更高效。根据场景灵活选择，甚至多个目的地同时输出也是常见做法。

f. 配置管理

把日志级别、输出路径、格式化方式等参数放到配置文件或环境变量里，而不是硬编码在程序中。这样在线上环境临时调整日志行为时，只需改个配置文件，不需要重新编译部署。

g. 错误处理

日志系统本身也要考虑健壮性。比如磁盘满了、日志文件无法写入，这时候至少应该有一个备选方案（比如回退到标准错误输出），或者有明确的告警机制，保证日志不会成为“静默失败”的源头。

4. 总结

在Linux环境下用C++做日志记录，思路其实很清晰：小项目或原型阶段，用标准库手写一个简单的记录器完全够用；一旦项目复杂起来，或者需要多线程、异步、轮转等高级功能，直接上 spdlog、log4cpp 或 Boost.Log 更省心。这三个库各有特点——spdlog 现代轻快，log4cpp 成熟稳定，Boost.Log 功能全面但稍重。选哪个，主要看团队的技术栈背景和项目对性能、可维护性的具体要求。最后，别忘了把上面提到的最佳实践落实到代码里，这才是让日志系统真正发挥价值的关键。