C++日志记录完全指南（从零开始掌握C++日志库与调试技巧）

为什么需要日志记录？

当你运行一个复杂程序时，如果出现异常或结果不符合预期，仅靠断点调试可能效率低下。而通过C++日志记录，你可以在关键位置输出变量值、函数调用路径或状态信息，帮助快速定位问题。

方法一：使用标准输出（最简单方式）

对于小型项目或学习阶段，可以直接使用 std::cout 或 std::cerr 输出日志：

#include <iostream>#include <string>int main() {    std::cout << "[INFO] 程序启动中..." << std::endl;    int x = 10;    std::cout << "[DEBUG] 变量x的值为: " << x << std::endl;    return 0;}

这种方式虽然简单，但缺乏日志级别控制、文件输出和时间戳等功能，不适合大型项目。

方法二：自定义简易日志类

我们可以封装一个简单的日志类，支持日志级别和时间戳：

#include <iostream>#include <fstream>#include <chrono>#include <ctime>#include <string>class SimpleLogger {public:    enum Level { INFO, WARNING, ERROR };    SimpleLogger(const std::string& filename) : logFile(filename, std::ios::app) {}    void log(Level level, const std::string& message) {        auto now = std::chrono::system_clock::now();        std::time_t timeT = std::chrono::system_clock::to_time_t(now);        char timeStr[20];        std::strftime(timeStr, sizeof(timeStr), "%Y-%m-%d %H:%M:%S", std::localtime(&timeT));        std::string levelStr;        switch (level) {            case INFO:    levelStr = "[INFO]"; break;            case WARNING: levelStr = "[WARNING]"; break;            case ERROR:   levelStr = "[ERROR]"; break;        }        std::string fullMsg = std::string(timeStr) + " " + levelStr + " " + message;        std::cout << fullMsg << std::endl;        if (logFile.is_open()) {            logFile << fullMsg << std::endl;        }    }private:    std::ofstream logFile;};// 使用示例int main() {    SimpleLogger logger("app.log");    logger.log(SimpleLogger::INFO, "程序已启动");    logger.log(SimpleLogger::WARNING, "内存使用偏高");    logger.log(SimpleLogger::ERROR, "文件未找到");    return 0;}

这个自定义日志类支持三种日志级别，并自动添加时间戳，同时将日志写入控制台和文件。这是C++开发教程中常见的实践方式。

方法三：使用成熟日志库（推荐）

对于生产环境，建议使用成熟的第三方日志库，如 spdlog、glog 或 Boost.Log。以 spdlog 为例：

1. 安装 spdlog（可通过 vcpkg、conan 或直接下载头文件）

2. 使用示例：

#include "spdlog/spdlog.h"#include "spdlog/sinks/basic_file_sink.h"int main() {    // 创建文件日志器    auto file_logger = spdlog::basic_logger_mt("file_logger", "logs/basic-log.txt");        // 设置日志级别    spdlog::set_level(spdlog::level::debug);        // 记录不同级别的日志    SPDLOG_LOGGER_INFO(file_logger, "程序启动成功");    SPDLOG_LOGGER_WARN(file_logger, "警告：配置文件缺失");    SPDLOG_LOGGER_ERROR(file_logger, "错误：数据库连接失败");        // 刷新日志    spdlog::shutdown();    return 0;}

使用 spdlog 这样的专业日志库，不仅能获得高性能、线程安全的日志功能，还能轻松实现日志轮转、格式定制等高级特性，是提升C++调试技巧的关键一步。

总结

无论你是刚接触C++的新手，还是正在构建大型系统的开发者，掌握C++日志记录都是必不可少的技能。从简单的 std::cout 到自定义日志类，再到专业的日志库如 spdlog，你可以根据项目需求选择合适的方式。

记住，良好的日志习惯不仅能加速调试过程，还能在系统上线后提供宝贵的运行数据。希望这篇C++开发教程能帮助你建立起高效的日志系统！

如果你觉得有用，不妨在自己的项目中尝试实现一个日志模块吧！