用std::chrono::system_clock::now()获取时间,转time_t得秒级部分,duration_cast取毫秒余数,再用ostringstream拼接为“YYYY-MM-DD HH:MM:SS.mmm”格式。

如何用 C++ 实现一个线程安全、带毫秒级时间戳的简易 Logger
直接结论:不需要第三方库,用 std::chrono + std::mutex + std::ofstream 就能写出轻量、可靠、可复用的 Logger。关键不是“功能多”,而是时间精度不丢、多线程写日志不乱、文件不崩溃。
std::chrono::system_clock::now() 怎么格式化成 “YYYY-MM-DD HH:MM:SS.mmm”
标准库不提供直接格式化毫秒的接口,得手动拆解。别用 std::put_time(它只到秒),也别用 C 风格 strftime(不支持毫秒)。正确做法是先转为 time_t 拿秒级部分,再用 duration_cast 提取毫秒余数:
auto now = std::chrono::system_clock::now();
auto time_t = std::chrono::system_clock::to_time_t(now);
auto ms = std::chrono::duration_cast<std::chrono::milliseconds>(now.time_since_epoch()) % 1000;
std::ostringstream oss;
oss << std::put_time(std::localtime(&time_t), "%Y-%m-%d %H:%M:%S");
oss << '.' << std::setfill('0') << std::setw(3) << ms.count();
// 结果形如 "2024-05-22 14:36:01.123"
- 必须用
std::localtime而非std::gmtime,否则时区错 -
% 1000是必须的——time_since_epoch()返回的是纳秒或微秒级值,直接除会溢出或截断 -
std::setfill('0') + std::setw(3)保证毫秒恒为三位,避免 “1.2” 这种错位
为什么必须加 std::mutex,以及锁粒度怎么选
多个线程同时调用 operator<< 写同一个 std::ofstream,会导致日志行交叉(比如 A 线程写一半被 B 插入,结果变成 “A1B1A2B2”)。但锁整个 log() 函数太重,锁 ofstream::write 又太细——正确粒度是锁「格式化 + 一次 write」这个原子操作:
组合式C++代码评审方案,融合静态分析、AI推理、多轮迭代评审和C++专项检查,适用于PR审查、增量代码审查、全项目评审和代码质量评分,触发词包括review cpp、cpp代码评审、C++review、代码审查。
class Logger {
std::ofstream file_;
mutable std::mutex mtx_;
public:
void log(const std::string& level, const std::string& msg) const {
std::lock_guard<std::mutex> lk(mtx_);
auto ts = format_timestamp(); // 上面那段逻辑
file_ << "[" << ts << "] [" << level << "] " << msg << "\n";
file_.flush(); // 关键:避免缓冲区滞留,尤其程序异常退出时
}
};
- 不要把
file_声明为std::ofstream&引用——构造时若文件打开失败,引用会悬空 -
file_.flush()必须加,否则大量日志可能卡在缓冲区里,调试时“明明调了 log 却看不到输出” - 如果追求极致性能且日志量极大,可考虑无锁环形缓冲 + 单独日志线程,但对“简单 Logger”属于过度设计
构造时打开文件失败怎么处理,以及 std::ofstream 的常见陷阱
最常被忽略的是:std::ofstream 默认不抛异常,open 失败后 file_.is_open() 为 false,但后续 << 操作静默失败——日志全丢,还毫无提示。
立即学习“C++免费学习笔记(深入)”;
- 必须在构造函数里检查:
if (!file_.is_open()) { throw std::runtime_error("Failed to open log file: " + filename); } - 避免使用相对路径(如
"log.txt")——当前工作目录不确定,建议用绝对路径或从环境变量读取 - 不要在每次
log()里重新 open/close 文件,磁盘 I/O 开销大,且并发时易冲突;应保持 long-lived file stream - 如果需要按天滚动日志,不能靠重命名正在写的文件(Windows 下会失败),得在每日首次 log 时检测日期并新建流
真正难的不是写几行格式化代码,而是确保时间不漂移、多线程不撕裂、文件句柄不泄漏、错误有反馈——这些细节一漏,Logger 就从调试帮手变成定时炸弹。

















