如何设置NLog日志文件最大大小？实现自动备份与新日志生成

阿华AIGC实验室

2026-5-28

在NLog中配置日志文件自动按大小轮转备份

当然有！NLog本身就内置了完善的日志轮转功能，完全可以满足你设置最大文件大小、自动备份带时间戳的旧日志并写入新文件的需求，而且这种内置实现是线程安全的，不用担心日志文件损坏。下面详细说怎么配置：

一、使用NLog内置配置（推荐）

你只需要在NLog的配置文件（或者代码配置）中，针对FileTarget设置几个关键参数即可。

1. XML配置示例（NLog.config）

这是最常用的配置方式，直接编辑你的NLog.config文件：

<nlog xmlns="http://www.nlog-project.org/schemas/NLog.xsd"
      xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

  <targets>
    <!-- 定义文件日志目标 -->
    <target name="rotatingFile" 
            xsi:type="File" 
            fileName="${basedir}/logs/current.log" <!-- 当前写入的日志文件 -->
            archiveFileName="${basedir}/logs/archive/log_{date:format=yyyyMMddHHmmss}_{#}.log" <!-- 备份文件命名模板 -->
            archiveAboveSize="5242880" <!-- 单个日志文件最大大小：5MB（5*1024*1024字节） -->
            archiveNumbering="Sequence" <!-- 同一时间多份备份用序列编号区分 -->
            archiveEvery="None" <!-- 禁用按时间自动轮转，只触发按大小轮转 -->
            maxArchiveFiles="10" <!-- 可选：最多保留10个备份文件，超过自动删除最旧的 -->
            concurrentWrites="true" <!-- 多线程写入安全保障 -->
            keepFileOpen="false" /> <!-- 避免长时间锁定文件，降低损坏风险 -->
  </targets>

  <rules>
    <!-- 所有日志级别≥Info的日志都写入这个目标 -->
    <logger name="*" minlevel="Info" writeTo="rotatingFile" />
  </rules>
</nlog>

2. 代码配置示例（C#）

如果是在代码中动态配置NLog，也可以这样写：

var config = new LoggingConfiguration();

var rotatingFileTarget = new FileTarget("rotatingFile")
{
    FileName = "${basedir}/logs/current.log",
    ArchiveFileName = "${basedir}/logs/archive/log_{date:format=yyyyMMddHHmmss}_{#}.log",
    ArchiveAboveSize = 5 * 1024 * 1024, // 5MB
    ArchiveNumbering = ArchiveNumberingMode.Sequence,
    ArchiveEvery = FileArchivePeriod.None,
    MaxArchiveFiles = 10,
    ConcurrentWrites = true,
    KeepFileOpen = false
};

// 添加日志规则
config.AddRule(LogLevel.Info, LogLevel.Fatal, rotatingFileTarget);

// 应用配置
LogManager.Configuration = config;

参数说明

archiveAboveSize：核心参数，设置单个日志文件的最大字节数，5MB就是5*1024*1024=5242880
archiveFileName：备份文件的命名模板，{date:format=yyyyMMddHHmmss}会在轮转时插入当前精确到秒的时间戳，{#}是序列编号（如果同一秒内触发多次轮转，会自动加1）
archiveEvery="None"：明确告诉NLog不要按时间（比如每天/每小时）自动轮转，只在文件大小超过限制时触发备份
maxArchiveFiles：可选参数，控制保留的备份文件数量，避免磁盘被日志占满
concurrentWrites="true"：确保多线程环境下日志写入不会冲突，是NLog保障日志安全的关键设置
keepFileOpen="false"：默认值，每次写入后关闭文件，避免长时间锁定，减少文件损坏的可能性