在C++项目开发中，一个轻量级的日志库能够帮助我们记录调试信息、警告和错误。下面介绍如何使用标准库实现一个具备级别控制、文件输出的简单日志系统。
一、日志级别设计
通常日志分为几种级别，方便在发布时屏蔽低优先级信息。我们定义如下枚举：
#include <iostream>
#include <fstream>
#include <string>
#include <mutex>
#include <chrono>
#include <iomanip>
enum class LogLevel {
DEBUG,
INFO,
WARN,
ERROR
};
// 将级别转为字符串
std::string level_to_string(LogLevel level) {
switch (level) {
case LogLevel::DEBUG: return "DEBUG";
case LogLevel::INFO: return "INFO";
case LogLevel::WARN: return "WARN";
case LogLevel::ERROR: return "ERROR";
default: return "UNKNOWN";
}
}
二、单例日志管理器
为了避免多处创建日志对象导致写文件冲突，我们使用单例模式管理全局日志器，并利用std::mutex保证多线程安全。
class Logger {
public:
static Logger& instance() {
static Logger inst;
return inst;
}
void set_file(const std::string& path) {
std::lock_guard<std::mutex> lock(mtx_);
if (file_.is_open()) file_.close();
file_.open(path, std::ios::app);
}
void log(LogLevel level, const std::string& msg) {
std::lock_guard<std::mutex> lock(mtx_);
auto now = std::chrono::system_clock::now();
auto t = std::chrono::system_clock::to_time_t(now);
std::string line = "[";
line += std::to_string(t);
line += "][";
line += level_to_string(level);
line += "] ";
line += msg;
line += "n";
std::cout << line;
if (file_.is_open()) {
file_ << line;
file_.flush();
}
}
private:
Logger() = default;
std::ofstream file_;
std::mutex mtx_;
};
三、便捷宏定义
通过宏简化调用方式，使代码更直观：
#define LOG_DEBUG(msg) Logger::instance().log(LogLevel::DEBUG, msg) #define LOG_INFO(msg) Logger::instance().log(LogLevel::INFO, msg) #define LOG_WARN(msg) Logger::instance().log(LogLevel::WARN, msg) #define LOG_ERROR(msg) Logger::instance().log(LogLevel::ERROR, msg)
四、使用示例
在程序启动处设置日志文件，之后任意位置都可写日志：
int main() {
Logger::instance().set_file("app.log");
LOG_INFO("程序启动");
LOG_DEBUG("调试信息示例");
LOG_WARN("内存占用较高");
LOG_ERROR("连接数据库失败");
return 0;
}
五、设计要点总结
- 使用枚举约束日志级别，便于过滤。
- 单例模式确保全局唯一写入入口。
- 互斥锁防止多线程交叉写乱。
- 同时输出到控制台和文件，方便排查。
以上就是一个最基础的C++日志库实现，你可以按需扩展为按大小滚动文件或支持异步队列。