C#怎么记录日志 C# Serilog日志框架配置方法

admin 百科 2025-12-21 14

Serilog是C#中推荐的轻量高性能结构化日志框架，支持多目标输出、自动序列化与命名属性；需在Program.cs中尽早配置Log.Logger，推荐注入ILogger并使用{Key}占位符实现结构化日志。

C#怎么记录日志 C# Serilog日志框架配置方法-第1张图片-佛山资讯网

在C#中记录日志，Serilog 是目前最推荐的轻量、高性能、结构化日志框架之一。它支持多种输出目标（控制台、文件、Elasticsearch、Seq 等），配置简单，且天然支持结构化日志（比如自动序列化对象、命名属性），比原生 Console.WriteLine 或 TextWriter 更专业、可维护性更强。

安装 Serilog 核心包和常用接收器

在项目中通过 NuGet 安装以下基础包：

Serilog：核心库
Serilog.Sinks.Console：输出到控制台（开发调试用）
Serilog.Sinks.File：输出到本地文件（生产环境常用）
Serilog.AspNetCore（如用 ASP.NET Core）：集成中间件和请求日志

命令行示例（Package Manager Console）：

Install-Package Serilog
Install-Package Serilog.Sinks.Console
Install-Package Serilog.Sinks.File
Install-Package Serilog.AspNetCore

基础配置（.NET 6/7/8 主机构建方式）

在 Program.cs 中配置全局日志提供器：

using Serilog;

var builder = WebApplication.CreateBuilder(args);

// 配置 Serilog（必须在 builder.Build() 之前）
Log.Logger = new LoggerConfiguration()
.MinimumLevel.Debug() // 最低日志等级
.WriteTo.Console() // 输出到控制台
.WriteTo.File("logs/myapp-.log", rollingInterval: RollingInterval.Day) // 按天滚动文件
.CreateLogger();

// 注入到 DI 容器（可选，但推荐）
builder.Services.AddLogging(loggingBuilder =>
loggingBuilder.AddSerilog(Log.Logger, dispose: true));

注意：Log.Logger 必须尽早初始化，否则启动过程中的异常可能无法记录。

标签： js json app c# .net

本文地址： https://www.fsgp.cn/p/baike/82768.html