C#怎么记录日志 C# Serilog日志框架配置方法-C#.Net教程-PHP中文网

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

幻夢星雲

发布： 2025-12-21 11:36:08

原创

115人浏览过

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

c#怎么记录日志 c# serilog日志框架配置方法

在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 必须尽早初始化，否则启动过程中的异常可能无法记录。

故事AI绘图神器

文本生成图文视频的AI工具，无需配音，无需剪辑，快速成片，角色固定。

查看详情

在代码中使用日志（注入 ILogger）

推荐在类中通过构造函数注入 ILogger<yourclass></yourclass>，而不是直接调用静态 Log.Information()（后者不利于单元测试和上下文隔离）：

public class UserService
{
private readonly ILogger _logger;

public UserService(ILogger logger)
{
_logger = logger;
}

public void CreateUser(string name, int age)
{
_logger.LogInformation("创建用户：{Name}，年龄：{Age}", name, age);
_logger.LogWarning("用户 {Name} 年龄 {Age} 接近上限", name, age);
_logger.Error(new Exception("DB timeout"), "创建用户失败");
}
}

结构化日志的关键是用 {Name} 占位符——Serilog 会把值作为结构化字段记录（例如 JSON 日志里会是 "Name": "Alice", "Age": 28），不是简单字符串拼接。