serilog

项目地址： https://github.com/serilog/serilog

官方文档： https://serilog.net/

NuGet： Serilog（核心，4.4.0）；Serilog.AspNetCore（10.0.0，版本跟随 Microsoft.Extensions.Hosting）

常用配套包： Serilog.Sinks.Console 6.1.1 / Serilog.Sinks.File 7.0.0 / Serilog.Settings.Configuration 10.0.1 / Serilog.Formatting.Compact 3.0.0（截至 2026-10，NuGet）

目标框架： net8.0 / net9.0 / net10.0 / netstandard2.0 / .NET Framework 4.6.2+

许可证： Apache-2.0

概述

Serilog 是 .NET 的结构化日志库：日志事件不是先拼成字符串，而是保留具名属性与值，再交给 sink 渲染成文本或 JSON。核心包 Serilog 只负责管道与事件模型，输出能力全部由 sink 包提供。

• 结构化事件：消息模板 "Processed {@Position} in {Elapsed} ms" 记录 Position / Elapsed 两个属性
• sink 可组合：控制台、文件、Seq、OpenTelemetry、Elasticsearch 等都通过 WriteTo.* 挂载
• 配置驱动：ReadFrom.Configuration(IConfiguration) 支持在 appsettings.json 中声明 sink 与级别
• ASP.NET Core 一等公民：Serilog.AspNetCore 把框架自身的 ILogger 输出接入 Serilog 管道，并提供单事件请求日志中间件
• 低开销：级别关闭时几乎不产生分配（Log.Logger 的 IsEnabled 短路）

日志管道的两个关键概念：

概念	作用	典型 API
Logger	事件入口，决定最小级别与 enricher	new LoggerConfiguration().MinimumLevel.Debug()
Sink	事件出口，决定写入哪里、什么格式	.WriteTo.Console() / .WriteTo.File(...)

---

安装

方式一：dotnet CLI（推荐）

# ASP.NET Core 项目：一个包带齐核心 + Console/File/Debug sink + 配置绑定
dotnet add package Serilog.AspNetCore

# 控制台 / Worker / 类库
dotnet add package Serilog
dotnet add package Serilog.Sinks.Console
dotnet add package Serilog.Sinks.File

方式二：PackageReference 直接写 csproj

<ItemGroup>
  <PackageReference Include="Serilog.AspNetCore" Version="10.0.0" />
  <PackageReference Include="Serilog.Sinks.Async" Version="2.1.0" />
  <PackageReference Include="Serilog.Enrichers.Environment" Version="3.0.1" />
</ItemGroup>

方式三：Visual Studio 包管理器控制台

Install-Package Serilog.AspNetCore -Version 10.0.0

验证安装

dotnet list package | grep -i serilog

控制台最小可运行验证（不依赖任何宿主）：

using Serilog;

using var log = new LoggerConfiguration()
    .WriteTo.Console()
    .CreateLogger();

log.Information("Hello, Serilog!");