C# 如何使用log4net或Serilog - 配置强大的日志记录框架

推荐新项目优先选Serilog，因其结构化日志支持好、配置简洁；老项目可继续用log4net。1. Serilog支持命名参数记录，便于查询分析，配置通过代码或JSON完成，集成ASP.NET Core只需UseSerilog()。2. log4net依赖XML配置，扩展性较弱，需手动桥接ILoggerFactory。3. 两者均需调用关闭方法确保日志落盘。

在 C# 项目中，log4net 和 Serilog 都是成熟、灵活的日志框架，但 Serilog 更现代、配置更简洁、结构化日志支持更好；log4net 功能稳定但 XML 配置繁琐、扩展性略弱。推荐新项目优先选 Serilog，老项目维护可继续用 log4net。

Serilog：轻量配置 + 结构化日志

Serilog 的核心优势是“结构化日志”——日志消息可带命名参数，便于后续查询和分析（比如写入 Elasticsearch 或 Seq）。

• 安装 NuGet 包：Serilog、Serilog.Sinks.Console（控制台）、Serilog.Sinks.File（文件）、Serilog.AspNetCore（ASP.NET Core 集成）
• 在 Program.cs（.NET 6+）中配置：

using Serilog;
Log.Logger = new LoggerConfiguration()
    .MinimumLevel.Debug()
    .WriteTo.Console()
    .WriteTo.File("logs/log-.txt", rollingInterval: RollingInterval.Day)
    .CreateLogger();
var builder = WebApplication.CreateBuilder(args);
builder.Host.UseSerilog(); // 启用 Serilog 全局日志

使用时直接注入 ILogger 或调用 Log.Information("User {Id} logged in at {Time}", userId, DateTime.Now) —— {Id} 和 {Time} 会作为结构化字段被记录，不只是字符串插值。

log4net：XML 驱动 + 成熟生态

log4net 依赖外部配置文件（如 log4net.config），适合已有 XML 管理习惯或需精细控制追加器（Appender）的老系统。

• 安装 log4net NuGet 包
• 添加 log4net.config 到项目，设“复制到输出目录=始终复制”
• 在 Program.cs 或 Startup.cs 中初始化：

XmlConfigurator.Configure(new FileInfo("log4net.config"));

典型配置片段（输出到文件 + 控制台）：

代码中使用：private static readonly ILog log = LogManager.GetLogger(typeof(Program));，然后 log.Info("Request processed");

关键差异与选型建议

• 结构化日志：Serilog 原生支持；log4net 需借助 LogEventInfo.Properties 手动附加，不直观
• 配置方式：Serilog 支持代码、JSON、环境变量等多种方式；log4net 几乎只靠 XML
• 异步写入：Serilog 默认支持（Async sink 包）；log4net 需自行包装或使用第三方 Appender
• ASP.NET Core 集成：Serilog 提供 UseSerilog() 一键接管所有内置日志；log4net 需手动桥接 ILoggerFactory

小技巧：快速启用 JSON 日志（Serilog）

若对接 ELK 或 Datadog，只需换一个 Sink：

.WriteTo.File(new JsonFormatter(), "logs/log-.json", rollingInterval: RollingInterval.Day)

每条日志自动转为 JSON 行格式，含时间、级别、消息、属性字段，开箱即用。

基本上就这些。Serilog 上手快、维护省心，log4net 胜在稳定和文档全。不复杂但容易忽略的是：无论选哪个，记得在应用退出前调用 Log.CloseAndFlush()（Serilog）或 LogManager.Shutdown()（log4net），确保缓冲日志落盘。