.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),便于日志搜索 生产环境中建议将日志按级别分离存储,并设置滚动策略防止文件过大基本上就这些,不复杂但容易忽略细节,比如文件路径权限、配置未加载等问题。只要按步骤配置,日志功能就能稳定运行。
