.NET如何使用log4net或Serilog记录日志_log4net Serilog日志记录教程

来源:这里教程网 时间:2026-02-21 17:29:46 作者:

.NET中使用log4net或Serilog记录日志是开发过程中非常实用的功能,能帮助开发者追踪程序运行状态、排查异常和监控系统行为。下面分别介绍如何在.NET项目中集成并使用log4net与Serilog,适合初学者快速上手。

配置log4net记录日志

log4net是一个成熟稳定的日志框架,广泛用于传统.NET Framework项目,也可在.NET Core/.NET中使用,但配置稍显复杂。

通过NuGet安装log4net:在项目中执行命令 Install-Package log4net 创建配置文件 log4net.config,内容如下:
<?xml version="1.0" encoding="utf-8"?>
<log4net>
  <appender name="FileAppender" type="log4net.Appender.FileAppender">
    <file value="logs\log.txt" />
    <appendToFile value="true" />
    <layout type="log4net.Layout.PatternLayout">
      <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
    </layout>
  </appender>
  <root>
    <level value="DEBUG" />
    <appender-ref ref="FileAppender" />
  </root>
</log4net>
在AssemblyInfo.cs中添加特性以加载配置(.NET Framework):
[assembly: log4net.Config.XmlConfigurator(ConfigFile = "log4net.config", Watch = true)]
在代码中使用:
private static readonly ILog log = LogManager.GetLogger(typeof(Program));
log.Info("程序启动");
log.Error("发生错误", exception);

注意:确保log4net.config的“复制到输出目录”设置为“始终复制”。

使用Serilog记录日志

Serilog更现代,语法简洁,支持结构化日志,在.NET Core/.NET项目中推荐使用。

通过NuGet安装核心包及写入器:
Install-Package Serilog
Install-Package Serilog.Sinks.File
在Program.cs中配置Serilog(以.NET 6+为例):
using Serilog;
<p>Log.Logger = new LoggerConfiguration()
.WriteTo.File("logs\myapp-.txt", rollingInterval: RollingInterval.Day)
.MinimumLevel.Debug()
.CreateLogger();</p><p>try
{
var builder = WebApplication.CreateBuilder(args);
builder.Host.UseSerilog(); // 使用Serilog替代默认日志
}
catch (Exception ex)
{
Log.Fatal(ex, "应用启动失败");
}
finally
{
Log.CloseAndFlush();
}</p>
在控制器或其他类中注入ILogger即可使用:
public class HomeController : Controller
{
    private readonly ILogger<HomeController> _logger;
<pre class='brush:php;toolbar:false;'>public HomeController(ILogger<HomeController> logger)
{
    _logger = logger;
}
public IActionResult Index()
{
    _logger.LogInformation("首页被访问");
    _logger.LogError("模拟异常");
    return View();
}

}

Serilog支持丰富的Sink扩展,如写入控制台、数据库、Elasticsearch、Seq等,只需安装对应Sinks包并配置WriteTo即可。

选择建议与注意事项

如果项目是基于旧版.NET Framework,log4net稳定可靠,配置一次可长期使用。如果是新项目,尤其是.NET Core或.NET 5+,优先选择Serilog,结构化日志更利于后期分析。

log4net依赖XML配置,修改后需重启生效;Serilog代码配置更灵活 Serilog支持属性绑定,例如Log.Information("用户{UserId}登录", userId),便于日志搜索 生产环境中建议将日志按级别分离存储,并设置滚动策略防止文件过大

基本上就这些,不复杂但容易忽略细节,比如文件路径权限、配置未加载等问题。只要按步骤配置,日志功能就能稳定运行。

相关推荐