首先推荐在.NET中使用Serilog或log4net记录日志,1. log4net需通过NuGet安装并配置XML文件,适用于传统.NET Framework项目;2. Serilog以代码方式配置,支持结构化日志,更适合.NET Core及以上版本;3. 配置时需注意文件路径、复制属性及日志滚动策略,确保日志正确输出与维护。

.NET中使用log4net或Serilog记录日志是开发过程中非常实用的功能,能帮助开发者追踪程序运行状态、排查异常和监控系统行为。下面分别介绍如何在.NET项目中集成并使用log4net与Serilog,适合初学者快速上手。
配置log4net记录日志
log4net是一个成熟稳定的日志框架,广泛用于传统.NET Framework项目,也可在.NET Core/.NET中使用,但配置稍显复杂。
- 通过NuGet安装log4net:在项目中执行命令 Install-Package log4net
- 创建配置文件 log4net.config,内容如下:
- 在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;Log.Logger = new LoggerConfiguration() .WriteTo.File("logs\myapp-.txt", rollingInterval: RollingInterval.Day) .MinimumLevel.Debug() .CreateLogger();
try { var builder = WebApplication.CreateBuilder(args); builder.Host.UseSerilog(); // 使用Serilog替代默认日志 } catch (Exception ex) { Log.Fatal(ex, "应用启动失败"); } finally { Log.CloseAndFlush(); }
- 在控制器或其他类中注入ILogger即可使用:
public class HomeController : Controller
{
private readonly ILogger _logger;
public HomeController(ILogger 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),便于日志搜索
- 生产环境中建议将日志按级别分离存储,并设置滚动策略防止文件过大
基本上就这些,不复杂但容易忽略细节,比如文件路径权限、配置未加载等问题。只要按步骤配置,日志功能就能稳定运行。










