讲师中心 微信公众号
AI工具推荐 视频效率加速

C#实现日志文件滚动 C#如何按日期或大小分割日志文件

酷敏君_5156

酷敏君_5156

发布时间:2026-02-22 14:13:02

|

269人浏览过

|

来源于php中文网

原创

NLog按日期滚动最直接,需设archiveEvery="Day"且enableArchiveFileCompression="false";Serilog按大小滚动更可控,须设rollOnFileSizeLimit=true和fileSizeLimitBytes;手动实现需避免FileStream锁与时钟误差。

c#实现日志文件滚动 c#如何按日期或大小分割日志文件

用 NLog 配置按日期滚动最直接

绝大多数 C# 项目不需要手写滚动逻辑,NLog 内置的 FileTarget 支持开箱即用的日期滚动。关键不是“能不能”,而是“怎么配不踩坑”。

常见错误是只设 archiveEvery="Day" 却没关掉 enableArchiveFileCompression="false"(默认为 true),结果每天生成一堆 .zip 文件而非纯文本,排查日志时反而更麻烦。

推荐配置片段:

<target xsi:type="File" name="file" fileName="${basedir}/logs/app.log"
      archiveFileName="${basedir}/logs/app.{#}.log"
      archiveEvery="Day"
      archiveNumbering="Rolling"
      maxArchiveFiles="30"
      enableArchiveFileCompression="false" />
  • archiveNumbering="Rolling":旧文件编号递增(app.1.log, app.2.log…),比 Date 模式更易脚本清理
  • maxArchiveFiles="30":硬性限制归档数,否则磁盘可能被撑爆——这是生产环境最容易被忽略的点
  • 路径中避免使用 ${date:format=yyyy-MM-dd} 做 fileName,会导致日志写入失败(NLog 不支持在主文件名里动态插日期)

用 Serilog + File sink 按大小切分更可靠

按大小滚动比按日期更可控,尤其适合高吞吐服务。Serilog 的 Serilog.Sinks.File 默认就支持,但默认行为容易误导人。

它不叫“按大小滚动”,而叫“按文件大小限制 + 自动重命名”。关键参数是 rollingInterval 和 retainedFileCountLimit,但真正触发切割的是 fileSizeLimitBytes。

示例代码:

Log.Logger = new LoggerConfiguration()
    .WriteTo.File("logs/app.log",
        fileSizeLimitBytes: 10_485_760, // 10MB
        rollOnFileSizeLimit: true,
        retainedFileCountLimit: 7,
        rollingInterval: RollingInterval.Day) // 这个值其实不影响大小滚动,仅用于命名后缀
    .CreateLogger();
  • rollOnFileSizeLimit: true 必须显式开启,否则即使设了 fileSizeLimitBytes 也无效
  • retainedFileCountLimit: 7 是保留的**总文件数**(当前 + 归档),不是“最多存 7 天”——这点文档写得模糊,实际测试会发现第 8 个归档产生时,最老的就被删了
  • 归档文件名形如 app.log.20240520.txt 或 app.log.1.txt,取决于 rollingInterval 设置;若只想按大小切、不掺日期,设成 RollingInterval.Infinite 即可

手动实现滚动要绕开 FileStream 锁和时间判断误差

真要自己写(比如嵌入式场景或规避第三方依赖),核心难点不在逻辑,而在两个地方:FileStream 的独占锁导致无法安全重命名正在写的文件;以及服务器时钟跳变让“是否跨天”判断出错。

C#
C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

解决方案不是修判断,而是换思路:

  • 用 File.Move() 前先 stream.Dispose(),别试图在流开着时移动文件
  • 不依赖 DateTime.Now.Date 判断是否换日,改用“记录上一次滚动时间戳 + 24 小时检查”,避免 NTP 校时或夏令时导致误切
  • 大小判断别用 FileInfo.Length(可能因缓存不准),而是在每次 WriteLine 后累加已写字节数,更实时

一句话:手动滚动不是“写个计时器+判断大小”,而是“管好文件句柄生命周期 + 用增量计数替代查询”。

log4net 的 RollingFileAppender 容易卡在 StaticLogFileName

老项目还在用 log4net 的话,RollingFileAppender 的 StaticLogFileName="false" 是开关,但默认是 true——这意味着即使你配了 datePattern,它也只写一个文件,不滚动。

典型错误配置:

<appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
  <file value="logs/app.log" />
  <datePattern value=".yyyy-MM-dd" />
  <rollingStyle value="Date" />
</appender>

缺了 <staticlogfilename value="false"></staticlogfilename>,上面配置完全无效。加上之后还要注意:datePattern 中的 . 会被当字面量,所以 .yyyy-MM-dd 生成的是 app.log.2024-05-20,而不是 app.2024-05-20.log。

真正想按日期生成 app.YYYY-MM-DD.log,得把 <file></file> 设为空,靠 datePattern 构建完整文件名,且必须配合 staticLogFileName="false"。

滚动逻辑本身不复杂,难的是边界:文件锁、时钟漂移、归档清理策略、压缩与可读性的权衡。选库时别只看“支持滚动”,要看它默认行为是否贴合你的运维习惯。

热门AI工具

更多
蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

Flowith
Flowith Hot

Flowith是一款基于画布和智能体工作流的 AI 协作工作空间。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

讯飞智文

一款面向学习和办公场景的AI文档创作工具,可辅助生成PPT与Word文档,提高资料整理和内容制作效率。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

相关专题

更多
format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

1829

2023.07.31

python中的format是什么意思
python中的format是什么意思

python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1231

2024.06.27

堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

6747

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2788

2023.08.10

length函数用法
length函数用法

length函数用于返回指定字符串的字符数或字节数。可以用于计算字符串的长度,以便在查询和处理字符串数据时进行操作和判断。 需要注意的是length函数计算的是字符串的字符数,而不是字节数。对于多字节字符集,一个字符可能由多个字节组成。因此,length函数在计算字符串长度时会将多字节字符作为一个字符来计算。更多关于length函数的用法,大家可以阅读本专题下面的文章。

1967

2023.09.19

Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

20

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

20

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

20

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

40

2026.11.05

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C++ Core Guidelines
C++ Core Guidelines

共0课时 | 0人学习

C++ Reference
C++ Reference

共0课时 | 0人学习

C++ 官方标准说明
C++ 官方标准说明

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn