首先定义日志级别枚举,设计包含时间戳、级别、文件名、行号、函数名和消息的格式,通过单例Logger类管理输出目标与级别过滤,结合宏自动注入源码信息,实现简洁调用,并可选加锁保证线程安全。

实现一个简单的C++日志库,核心目标是让开发者能方便地输出带有级别、时间戳和来源信息的调试或运行日志。不需要依赖第三方库的情况下,通过封装文件操作、字符串格式化和线程安全机制,就可以构建一个轻量但实用的日志系统。
1. 定义日志级别
日志级别用于区分消息的重要程度,常见级别有:DEBUG、INFO、WARN、ERROR、FATAL。可以通过枚举来定义:
enum class LogLevel {
DEBUG,
INFO,
WARN,
ERROR,
FATAL
};
在输出时根据级别决定是否写入,也可以控制输出颜色(如终端中ERROR用红色)。
2. 日志格式设计
每条日志通常包含:时间戳、日志级别、源文件名、行号、函数名和用户消息。例如:
立即学习“C++免费学习笔记(深入)”;
[2025-04-05 10:23:45] [ERROR] main.cpp:42 in main: Failed to open file
可通过__FILE__、__LINE__、__func__宏自动获取位置信息。时间戳使用std::chrono和std::put_time生成。
3. 核心日志类设计
创建一个单例风格的Logger类,管理输出目标(控制台或文件)、日志级别过滤和格式化输出。
class Logger {
public:
static Logger& instance() {
static Logger logger;
return logger;
}
void set_level(LogLevel level) { level_ = level; }
void set_output_file(const std::string& filename);
void log(LogLevel level, const char* file, int line,
const char* func, const std::string& msg);private:
LogLevel level_ = LogLevel::DEBUG;
std::ofstream filestream;
bool usefile = false;
};
log方法中先判断当前级别是否需要输出,再格式化内容并写入目标流。
4. 简化调用的宏封装
直接调用log函数冗长,使用宏自动注入文件、行号等信息:
#define LOG_DEBUG(msg) Logger::instance().log(LogLevel::DEBUG, __FILE__, __LINE__, __func__, msg) #define LOG_INFO(msg) Logger::instance().log(LogLevel::INFO, __FILE__, __LINE__, __func__, msg) #define LOG_ERROR(msg) Logger::instance().log(LogLevel::ERROR, __FILE__, __LINE__, __func__, msg)
这样调用就变得简洁:
LOG_ERROR("Failed to connect to server");
5. 可选增强功能
进阶功能可按需添加:
- 线程安全:在log方法中加互斥锁,防止多线程输出混乱。
- 异步写入:将日志放入队列,由后台线程写入磁盘,避免阻塞主逻辑。
- 自动分割日志文件:按大小或日期创建新文件,避免单个文件过大。
-
支持格式化参数:类似printf,使用
std::vsnprintf处理可变参数。
基本上就这些。一个简单日志库的关键是清晰的接口和稳定的输出格式。不复杂但容易忽略的是错误处理,比如文件无法打开时应自动回退到控制台输出。从简单开始,逐步扩展,就能构建出适合项目的日志系统。











