推荐用 std::chrono 获取时间点再用 std::put_time 格式化生成文件名,可自动补零、适配 locale;避免 std::localtime 多线程不安全;格式建议 "%Y%m%d_%H%M%S"。

用 std::chrono 和 std::put_time 生成带日期的文件名
直接拼字符串容易出错,比如月份/日期少一位、时区错乱、格式不一致。C++11 起推荐用 std::chrono 获取当前时间点,再用 std::put_time 格式化——它能自动补零、适配 locale,比手撕 strftime 更稳。
- 别用
std::time(nullptr)配std::localtime:多线程下localtime返回静态缓冲区指针,可能被覆盖 - 格式串建议用
"%Y%m%d_%H%M%S",避免斜杠、冒号(Windows 不允许),也避开空格(shell 处理麻烦) - 示例:
auto now = std::chrono::system_clock::now(); auto time_t = std::chrono::system_clock::to_time_t(now); std::stringstream ss; ss
加序号防同秒冲突,而不是靠毫秒
日志高频写入时,哪怕同一秒内也可能生成多个文件。想靠毫秒(std::chrono::milliseconds)补在文件名里?不现实——std::system_clock::now() 的实际精度因平台而异,Windows 下常是 15ms,Linux 可能 1–10ms,且无法保证单调递增。
- 更可靠的做法:同一秒内首次生成用基础名,后续用
log_20240615_142305_1.txt这种带序号的变体 - 用一个
static std::map<:string int>缓存“已生成的秒级时间戳 → 当前序号”,每次生成前查表+自增 - 注意线程安全:如果多线程同时调用,得用
std::mutex锁住这个 map 操作,否则序号会跳或重复
检查文件是否存在再决定是否加序号
光靠时间戳+序号还不够。万一程序崩溃重启,上一秒生成的文件还躺在磁盘里,新进程又从序号 1 开始,就会覆盖旧日志。
- 生成文件名后,必须调用
std::filesystem::exists(filename)(C++17)或access(filename.c_str(), F_OK)(POSIX)确认文件未存在 - 只在
exists()返回true时才触发序号逻辑,否则直接用基础名 - 别省略这步:有些项目图省事只靠时间戳,结果凌晨服务自动拉起时,和前一天末尾的日志撞名,丢数据
Windows 下注意长路径和保留字
生成的文件名最终要能被系统接受。Windows 对路径长度、非法字符、设备名保留字极其敏感,而开发者常在 Linux/macOS 上测试,上线才踩坑。
- 路径总长别超
MAX_PATH(默认 260 字符),尤其当基础路径本身很长时,日期+序号+扩展名容易溢出 - 文件名里禁用
, :, ", /, \, |, ?, *,std::put_time默认不产生这些,但自己拼前缀/后缀时要过滤 - 别用
CON、AUX、NUL等作前缀——比如CON_20240615.txt在 Windows 下根本创建失败,错误是"The system cannot find the file specified.",非常误导
实际最难处理的是并发写入与文件系统延迟之间的博弈:你检查了文件不存在,正准备创建,另一线程瞬间完成同名创建,你的 std::ofstream 构造就会静默失败(除非显式检查 is_open())。这事没法靠命名完全规避,得配合原子性写入策略。
C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!











