Linux C++应用怎样进行日志记录

作者：袖梨 2026-07-20

在Linux环境下使用C++进行日志记录，可以采用多种方法。以下介绍几种常用的日志库及其基本用法：

1. 使用标准库 `<iostream>` 和文件流

这是最基础的方法，通过C++的标准输入输出流将日志写入文件。

#include <iostream>#include <fstream>#include <string>#include <ctime>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 << "无法打开日志文件。" << std::endl;}}int main() {logMessage("程序启动");// ... 程序逻辑 ...logMessage("程序结束");return 0;}

优点：

简单易用，无需依赖外部库。

缺点：

功能有限，缺乏日志级别、格式化、异步写入等高级功能。

2. 使用第三方日志库

为了实现更强大的日志功能，推荐使用成熟的第三方日志库。以下介绍几个常用的C++日志库：

a. spdlog

spdlog 是一个非常快速且功能丰富的C++日志库。

安装：可以通过包管理器安装，例如在Ubuntu上使用apt：

sudo apt-get install libspdlog-dev

示例代码：

#include "spdlog/spdlog.h"#include "spdlog/sinks/basic_file_sink.h"int main() {// 创建一个基本文件日志记录器，日志级别为info，日志文件名为logs/basic.txtauto 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日志");// 也可以使用info级别的日志记录器auto info_logger = spdlog::get("basic_logger");info_logger->info("再次记录info日志");return 0;}

优点：

高性能，支持异步日志记录。
支持多种日志格式和目标（控制台、文件、多文件轮转等）。
易于集成和使用。

b. log4cpp

log4cpp 是一个受Java Log4j启发的C++日志库。

安装：可以从源码编译安装，或者使用包管理器（如apt）：

sudo apt-get install liblog4cpp5-dev

示例代码：

#include <log4cpp/Category.hh>#include <log4cpp/FileAppender.hh>#include <log4cpp/OstreamAppender.hh>#include <log4cpp/BasicLayout.hh>int main() {// 创建布局log4cpp::BasicLayout* layout = new log4cpp::BasicLayout();// 创建文件追加器并设置布局log4cpp::FileAppender* fileAppender = new log4cpp::FileAppender("default", "app.log");fileAppender->setLayout(layout);// 创建控制台追加器并设置布局log4cpp::OstreamAppender* consoleAppender = new log4cpp::OstreamAppender("console", &std::cout);consoleAppender->setLayout(layout);// 获取根类别并添加追加器log4cpp::Category& root = log4cpp::Category::getRoot();root.addAppender(fileAppender);root.addAppender(consoleAppender);// 设置日志级别root.setPriority(log4cpp::Priority::INFO);// 记录日志root.info("这是一条info日志");root.error("这是一条error日志");// 清理资源delete layout;delete fileAppender;delete consoleAppender;return 0;}

优点：

功能丰富，支持多种日志输出方式和布局。
成熟稳定，社区支持较好。

缺点：

相较于spdlog，性能稍逊。
配置相对复杂，需要手动管理追加器和布局。

c. Boost.Log

Boost.Log 是Boost库中的一个组件，提供灵活且强大的日志功能。

安装：需要安装Boost库，具体步骤可以参考Boost官网。

示例代码：

#include <boost/log/trivial.hpp>#include <boost/log/utility/setup/file.hpp>#include <boost/log/utility/setup/console.hpp>#include <boost/log/sources/severity_logger.hpp>#include <boost/log/sources/record_ostream.hpp>namespace logging = boost::log;namespace src = boost::log::sources;namespace sinks = boost::log::sinks;void init_logging() {// 设置日志格式logging::add_console_log(std::cout,logging::keywords::format = "%TimeStamp%: %Message%");// 设置文件日志logging::add_file_log("app.log",keywords::format = "%TimeStamp%: %Message%",keywords::rotation_size = 10 * 1024 * 1024, // 10MBkeywords::time_based_rotation = sinks::file::rotation_at_time_point(0,0,0),keywords::auto_flush = true);}int main() {init_logging();BOOST_LOG_TRIVIAL(info) << "这是一条info日志";BOOST_LOG_TRIVIAL(warning) << "这是一条警告日志";BOOST_LOG_TRIVIAL(error) << "这是一条错误日志";return 0;}

优点：

与Boost库集成良好，适合已经在使用Boost的项目。
功能强大，支持复杂的日志配置和过滤。

缺点：

学习曲线较陡，配置相对复杂。
依赖Boost库，增加了项目的依赖项。

3. 日志记录的最佳实践

无论使用哪种日志库，以下最佳实践可以帮助你更好地管理和维护日志：

选择合适的日志级别：根据需要设置不同的日志级别（如DEBUG, INFO, WARN, ERROR, FATAL），以便在不同环境下控制日志输出量。
日志格式化：包含时间戳、线程ID、日志级别、模块名称等信息，便于排查问题。
日志轮转：对于长期运行的应用，配置日志文件的轮转策略，防止日志文件过大。
异步日志：使用异步日志记录可以提高应用的性能，避免日志写入成为性能瓶颈。
日志存储与安全：根据应用需求，决定日志的存储位置和安全措施，如加密敏感信息。
统一管理：在大型项目中，统一日志接口和管理，确保日志的一致性和可维护性。

4. 示例：使用spdlog实现高级日志功能

以下是一个使用spdlog实现多线程、异步日志记录及日志轮转的示例：

#include "spdlog/spdlog.h"#include "spdlog/sinks/rotating_file_sink.h"#include "spdlog/sinks/stdout_color_sinks.h"#include <thread>#include <vector>void worker_thread(int id) {auto logger = spdlog::get("console");for(int i = 0; i < 10; ++i){logger->info("线程 {} - 日志消息 {}", id, i);std::this_thread::sleep_for(std::chrono::milliseconds(100));}}int main() {// 创建控制台日志记录器，支持颜色输出auto console = spdlog::stdout_color_mt("console");// 创建一个旋转文件日志记录器，最大10MB，保留3个备份auto file_logger = spdlog::rotating_file_mt("logs/rotating.log", 10*1024*1024, 3);// 设置全局日志级别spdlog::set_level(spdlog::level::info);// 设置默认日志记录器spdlog::set_default_logger(console);// 记录启动信息spdlog::info("程序启动");// 创建多个线程进行日志记录std::vector<std::thread> threads;for(int i = 0; i < 5; ++i){threads.emplace_back(worker_thread, i);}// 等待所有线程完成for(auto &t : threads){t.join();}// 记录结束信息spdlog::info("程序结束");return 0;}

说明：