在 .NET Core 项目中，日志记录是一个重要的部分，它有助于诊断问题、监控应用程序的性能以及理解系统的行为。Log4Net 是一个功能强大的日志记录框架，它支持多种日志记录级别，并且可以灵活地配置日志的输出格式和存储位置。在 .NET Core 中使用 Log4Net 可以为应用程序提供强大的日志记录功能。

本文将介绍如何在 .NET Core 项目中集成 Log4Net，并展示如何使用它记录日志。

一、安装 Log4Net

首先，你需要在你的 .NET Core 项目中安装 Log4Net。你可以通过 NuGet 包管理器来安装。在 Visual Studio 中，打开“程序包管理器控制台”(Package Manager Console)，然后输入以下命令：

Install-Package log4net
Install-Package log4net.AspNetCore

第一个包 log4net 是 Log4Net 的核心库，而第二个包 log4net.AspNetCore 是为 ASP.NET Core 提供的集成支持。

二、配置 Log4Net

在项目中添加 Log4Net 之后，你需要配置它。通常，这通过创建一个名为 log4net.config 的配置文件来完成，该文件可以放在项目的根目录或任何可以访问的位置。以下是一个基本的 Log4Net 配置示例：

<?xml version="1.0" encoding="utf-8" ?>
<configuration>
  <configSections>
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net" />
  </configSections>
  <log4net>
    <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
      <file value="logs/app.log" />
      <appendToFile value="true" />
      <rollingStyle value="Size" />
      <maxSizeRollBackups value="5" />
      <maximumFileSize value="10MB" />
      <staticLogFileName value="true" />
      <layout type="log4net.Layout.PatternLayout">
        <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
      </layout>
    </appender>
    <root>
      <level value="DEBUG" />
      <appender-ref ref="RollingFileAppender" />
    </root>
  </log4net>
</configuration>

在这个配置中，我们定义了一个名为 RollingFileAppender 的文件追加器，它会在 logs 文件夹中创建一个名为 app.log 的日志文件，并且当文件大小超过 10MB 时会滚动。我们还设置了日志记录级别为 DEBUG，这意味着所有 DEBUG 级别及以上的日志都会被记录。

三、初始化 Log4Net

在 .NET Core 项目中，你需要在程序启动时初始化 Log4Net。这通常在 Program.cs 文件的 Main 方法中完成。以下是一个示例：

using log4net;
using log4net.Config;
using System;

namespace MyApp
{
    class Program
    {
        private static readonly ILog log = LogManager.GetLogger(typeof(Program));

        static void Main(string[] args)
        {
            log4net.Config.XmlConfigurator.Configure(new FileInfo("log4net.config"));

            // 现在可以使用 log 对象来记录日志了
            log.Info("Application started.");

            // ... 其他代码 ...
        }
    }
}

在上面的代码中，我们使用 log4net.Config.XmlConfigurator.Configure 方法加载了 log4net.config 配置文件，并且获取了一个 ILog 实例来记录日志。

四、使用 Log4Net 记录日志

一旦 Log4Net 被初始化并配置好，你就可以在你的代码中使用它来记录日志了。以下是一个简单的示例：

using log4net;

public class MyService
{
    private static readonly ILog log = LogManager.GetLogger(typeof(MyService));

    public void DoSomething()
    {
        try
        {
            // ... 执行一些操作 ...

            log.Debug("Did something.");
        }
        catch (Exception ex)
        {
            log.Error("An error occurred: " + ex.Message, ex);
        }
    }
}

在这个示例中，我们创建了一个 ILog 实例，并在不同的地方记录了不同级别的日志。