.NET 项目实战：NLog 日志框架配置与封装

配置要点说明

• Targets（目标）：定义了日志输出的位置。这里使用了 AsyncWrapper 包裹 File 目标，利用异步机制提升性能，避免 I/O 阻塞主线程。archiveAboveSize 设置了归档阈值，超过 100KB 自动切割文件。
• Rules（规则）：控制日志流向。final="true" 表示匹配后不再继续向下匹配，用于过滤特定命名空间（如 Microsoft）的冗余日志。通配符 * 可匹配任意记录器名称。

封装日志工具类

为了避免在每个类中重复实例化 Logger，可以封装一个静态辅助类。这样调用时只需关注业务逻辑，无需关心底层实现细节。

using NLog;

namespace YourNamespace.Utils
{
    /// <summary>
    /// NLog 使用帮助类
    /// </summary>
    public class LoggerHelper
    {
        private readonly Logger _logger = LogManager.GetCurrentClassLogger();

        #region Debug
        public void Debug(string msg) => _logger.Debug(msg);
        public void Debug(string msg, Exception err) => _logger.Debug(err, msg);
        #endregion

        #region Info
        public void Info(string msg) => _logger.Info(msg);
        public void Info(string msg, Exception err) => _logger.Info(err, msg);
        #endregion

        #region Warn
        public void Warn(string msg) => _logger.Warn(msg);
        public void Warn(string msg, Exception err) => _logger.Warn(err, msg);
        #endregion

        #region Error
        public void Error(string msg) => _logger.Error(msg);
        public void Error(string msg, Exception err) => _logger.Error(err, msg);
        #endregion

        #region Fatal
        public void Fatal(string msg) => _logger.Fatal(msg);
        public void Fatal(string msg, Exception err) => _logger.Fatal(err, msg);
        #endregion
    }
}

在实际使用中，直接调用 new LoggerHelper().Error("操作失败", ex) 即可。由于 LogManager.GetCurrentClassLogger() 会根据当前类名自动创建记录器，不同模块的日志会自动区分，便于追踪问题来源。

运行效果验证

配置完成后，启动项目并触发日志记录。日志文件将按日期自动分类存储在 ProjectLogs 目录下，文件名包含记录器名称和日志级别。控制台则会实时显示警告及错误信息，方便调试阶段快速定位异常。