Linux下C++日志记录详解

在Linux环境下，C++程序实现日志记录有多种可行方案。从标准库自带的简易方法，到功能完备的第三方库，再到系统级的syslog服务，不同方案适用于不同场景。以下介绍几种主流选择，帮助您根据项目需求做出最佳决策。

1. 使用标准库

C++标准库本身并未提供日志功能，但通过文件流（std::ofstream）可以自行构建一个简单的日志记录器。以下代码演示了如何向文件追加时间戳和消息：

#include 
#include 
#include 
#include 

void logMessage(const std::string& message) {
    std::ofstream logFile("app.log", std::ios::app);
    if (logFile.is_open()) {
        time_t now = time(0);
        char* dt = ctime(&now);
        logFile << "[" << dt << "] " << message << std::endl;
        logFile.close();
    } else {
        std::cerr << "Unable to open log file" << std::endl;
    }
}

int main() {
    logMessage("This is a log message.");
    return 0;
}

这种方法非常轻量，适合小型项目或临时调试。但当日志量增大，或需要多线程安全、日志轮转等高级特性时，第三方库会是更好的选择。

2. 使用第三方日志库

a. Boost.Log

Boost.Log是Boost库家族的一员，功能十分全面。它支持文件轮转、控制台输出、自定义格式、多线程安全等特性，几乎可以满足所有企业级需求。以下是一个典型的初始化配置示例：

#include 
#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 initLogging() {
    // 添加文件日志后端
    typedef sinks::text_file_backend< sinks::file::rotation_size<10*1024*1024>, sinks::file::time_based_rotation > file_backend;
    file_backend backend;
    backend.add_file("app.log");
    backend.auto_flush(true);

    // 添加控制台日志后端
    typedef sinks::synchronous_sink< sinks::text_ostream_backend< sinks::text_ostream_backend::stream_type& > > text_sink;
    text_sink sink(std::cout);
    sink.backends.push_back(backend);

    // 设置日志格式
    expr::stream< expr::keyword::tag< "Severity" >, expr::keyword::tag< "Message" > > formatter = expr::stream
        << "[" << expr::attr< std::string >("Severity") << "] "
        << expr::attr< std::string >("Message");
    sink.set_formatter(formatter);

    // 添加日志属性
    logging::add_common_attributes();

    // 注册日志记录器
    logging::core::get()->add_sink(sink);
}

int main() {
    initLogging();
    BOOST_LOG_TRIVIAL(info) << "This is an info message.";
    BOOST_LOG_TRIVIAL(warning) << "This is a warning message.";
    BOOST_LOG_TRIVIAL(error) << "This is an error message.";
    return 0;
}

不过，Boost.Log的配置相对复杂，编译依赖也较重。如果项目已经使用了Boost，那么集成Boost.Log自然顺理成章；否则，可以考虑更轻量的替代方案。

b. spdlog

spdlog是近年来非常流行的日志库，以“快速”和“易用”著称。其header-only模式让集成极为简便，同时支持多种输出目标（控制台、文件、syslog等），性能表现也十分出色。以下是一个同时输出到控制台和文件的示例：

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

int main() {
    // 创建控制台日志记录器
    auto console_sink = std::make_shared<:sinks::stdout_color_sink_mt>();
    console_sink->set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v");
    spdlog::register_logger(console_sink);

    // 创建文件日志记录器
    auto file_sink = std::make_shared<:sinks::basic_file_sink_mt>("app.log", true);
    file_sink->set_pattern("[%Y-%m-%d %H:%M:%S] [%l] %v");
    spdlog::register_logger(file_sink);

    // 获取日志记录器
    auto logger = spdlog::get("console");
    logger->info("This is an info message.");
    logger->warn("This is a warning message.");
    logger->error("This is an error message.");

    return 0;
}

spdlog的API设计直观易用，格式化语法与Python的logging模块类似，上手门槛较低。如果项目对性能要求较高，又不想引入Boost这样的大型依赖，spdlog是非常值得推荐的选择。

3. 使用系统日志

Linux系统自带的syslog服务也是一个可行的选项。通过syslog.h提供的接口，可以方便地将日志发送到系统日志守护进程（如rsyslog），由系统统一管理。以下是一个简单示例：

#include 
#include 
#include 

void logMessage(const std::string& message) {
    openlog("myapp", LOG_PID | LOG_CONS, LOG_USER);
    syslog(LOG_INFO, "%s", message.c_str());
    closelog();
}

int main() {
    logMessage("This is a log message.");
    return 0;
}

使用syslog的好处是无需额外配置，日志自动归入系统管理，便于与其他系统日志一同监控。但缺点同样明显：灵活性有限，自定义格式和输出目标比较麻烦，且日志位置（通常为/var/log/syslog）可能因Linux发行版而异。

总结

选择哪种日志记录方法，关键取决于项目需求。如果只是临时调试或小型工具，使用标准库或syslog即可，省心省力。如果项目需要日志级别、格式化、多线程支持、文件轮转等高级功能，则应当选用Boost.Log或spdlog这类专业日志库。从实际项目经验来看，spdlog在轻量级与性能之间取得了良好的平衡，已成为当前许多C++开发者的首选方案。