spdlog按大小滚动需用rotating_file_sink_mt,设filename、max_size(字节)、max_files(保留文件数);按天滚动需用daily_file_sink_mt,设rotation_hour/minute及max_files(保留天数);二者不可混用同一sink。

spdlog按大小滚动:用rotating_file_sink_mt控制单文件上限
要让日志按大小自动切分(比如每个文件最多60MB),必须用rotating_file_sink_mt,而不是basic_file_sink_mt或daily_file_sink_mt。它不看时间,只盯当前文件字节数。
关键参数有三个:filename(基础名,如"app.log")、max_size(单文件最大字节数)、max_files(保留几个旧文件)。注意:max_size单位是字节,写60 * 1024 * 1024比硬写62914560可读性强得多。
- 文件命名固定为
basename.0(当前写入)、basename.1…basename.N-1,轮转时老文件序号+1,最老的被删 -
max_files = 10意味着磁盘上最多存10个文件,总空间≈max_size × 10,不是“保留最近10天” - 如果程序崩溃未正常关闭,
rotating_file_sink_mt不会丢失最后几条日志,但也不会主动刷盘——得靠logger->flush_on(spdlog::level::info)或手动logger->flush()
spdlog按天滚动:用daily_file_sink_mt指定切割时刻
想每天凌晨0点或上午6点生成新日志?必须选daily_file_sink_mt。它靠系统时钟被动触发,不是定时器轮询,所以功耗低、精度够用。
构造时传入的rotation_hour和rotation_minute决定切割时间点。比如daily_file_sink_mt("app.log", 6, 0)表示每天6:00创建新文件;若程序在5:59启动,当天仍用旧文件,直到6:00才切。
-
truncate参数默认false,即新文件不覆盖已有同名日志;设为true则每次启动都清空当日文件(慎用) -
max_files在这里指最多保留多少个“日期级”文件,比如设为30就只留最近30天的日志,超期的按文件名时间戳删除 - 文件名自动带日期后缀:
app.log.2026-09-28、app.log.2026-09-29,不依赖序号,排查时更直观
同时满足大小+天数限制?只能组合两个sink或换策略
spdlog原生不支持“单个sink既按天又按大小滚动”。rotating_file_sink_mt无视时间,daily_file_sink_mt无视大小——二者逻辑互斥,不能混用同一个sink实例。
常见折中方案有两种:
- 只用
daily_file_sink_mt+ 合理设max_files,靠天数兜底控总量(适合日志量较稳定的服务) - 只用
rotating_file_sink_mt+ 脚本定期清理(例如Linux用find logs/ -name "app.log.*" -mtime +7 -delete) - 高级做法:自定义sink继承
spdlog::sinks::base_sink<mutex></mutex>,在log里同时检查时间和大小,但开发成本高,一般项目没必要
别试图把两个sink绑给同一个logger来“叠加效果”——它们会各自写各自的文件,导致日志分散、难以关联。
容易踩的坑:max_files行为差异和文件残留
max_files在两种sink里语义不同,这是最容易混淆的点:
- 对
rotating_file_sink_mt:指序号0~N-1共N个文件,轮转时直接删掉basename.N-1再重命名,不看文件修改时间 - 对
daily_file_sink_mt:指按文件名解析出的日期数量,比如有app.log.2026-09-25到app.log.2026-09-29共5个,设max_files=3就会删掉最早那两个
另外,daily_file_sink_mt初始化时会扫描目录匹配basename.*文件,若目录里混着rotating留下的app.log.0、app.log.1,可能误判或报错。生产环境建议两类日志分目录存放,比如logs/rotate/和logs/daily/。











