用 tellp() 检测日志大小最轻量,但需先 flush 并处理 - 1 返回值;超限时应原子重命名归档再以 out|trunc|binary 模式重建文件,避免追加或文本模式误判。

用 std::ofstream::tellp() 检测日志文件是否超限
直接读取当前写入位置是判断文件大小最轻量的方式,tellp() 返回的是流内部缓冲区 + 已刷盘字节数的近似值,不是系统级 stat() 结果,但对日志场景足够可靠。它快、无系统调用、不依赖平台 API。
常见错误是调用 tellp() 前没确保缓冲区已刷新,导致返回值偏小——比如连续写入后立刻检查,可能漏掉缓冲区里还没落盘的几百字节。
- 每次写日志前先调用
log_stream.flush(),再调用log_stream.tellp() - 如果日志量大、频率高,避免每条都 flush —— 改为「写前检测 + 写后按需 flush」:只在接近上限时 flush 并重检
- 注意
tellp()在文件为空或刚打开时可能返回-1(失败),需判空:if (pos == -1) pos = 0;
超过大小后如何安全重建日志文件
直接 close() + open() 有竞态风险:多线程 / 多进程下可能丢日志,或新文件被覆盖。核心原则是「原子替换」+「旧文件保留命名」。
典型做法不是清空原文件,而是重命名旧文件、新建同名文件。Windows 和 Linux 下 rename() 对同目录文件是原子的,C++ 标准库没直接封装,得用 std::filesystem::rename()(C++17)或系统 API。
立即学习 “C++ 免费学习笔记(深入)”;
- 先获取当前文件名,如
"app.log",生成归档名"app.log.20240520_142315"(含时间戳) - 用
std::filesystem::rename("app.log", archive_name)原子重命名 - 重新构造
std::ofstream打开"app.log"(自动创建新空文件) - 若
rename()失败(如磁盘满、权限不足),不要静默忽略——记录错误并继续写原文件,否则日志丢失不可逆
std::ofstream 重建时的打开模式陷阱
很多人用 std::ofstream("app.log", std::ios::out) 重建,结果旧内容没清空、新日志追加到末尾——这完全违背“限制大小”的初衷。
关键在模式组合:std::ios::out | std::ios::trunc 才能清空重写;但仅 trunc 不够,必须显式指定 out,否则某些标准库实现会静默失败。
- 正确写法:
std::ofstream log_stream("app.log", std::ios::out | std::ios::trunc); - 别用
std::ios::app,它强制追加,trunc会被忽略 - 如果需要保留部分旧日志(如最后 100 行),就不能 trunc,得手动读取原文件、截断、再写入新文件——这已超出
tellp()能力范围,需额外逻辑
跨平台与性能要注意的真实细节
tellp() 在 Windows 上对文本模式文件可能返回非字节数(换行符 rn 被算作 1 字符),导致大小误判。必须用二进制模式打开日志流,哪怕内容是纯文本。
另外,频繁调用 tellp() 本身开销极小,但配合 flush() 就变成实际 I/O,高并发写日志时可能成瓶颈。
- 打开文件时务必加
std::ios::binary:std::ofstream("app.log", std::ios::out | std::ios::trunc | std::ios::binary) - 不要每条日志都检测大小——设一个阈值(如上限的 90%),只在写入后
tellp()超过该值时才触发归档流程 - 归档操作(rename + reopen)应尽量快,避免阻塞日志线程;如有大量日志待写,可先缓存到内存队列,归档完成后再批量刷出
事情说清了就结束。真正难的不是检测大小,而是归档瞬间的原子性、错误恢复和多线程下的状态同步——这些没法靠 tellp() 解决。