WPF 桌面应用：Log4net 日志系统集成指南

在桌面端开发中，日志不仅是调试的利器，更是定位用户端“运行崩溃”的唯一线索。Log4net 作为 .NET 生态中长盛不衰的日志框架，其强大的文件滚动更新（Rolling）功能非常适合桌面应用。

第一步：安装与基础配置#

通过 NuGet 安装 log4net 后，在 App.config 中进行配置。

优化建议：避免直接将日志写在 D:// 根目录（这通常需要管理员权限）。建议使用相对路径或系统环境变量。

1
<configuration>
2
  <configSections>
3
    <section name="log4net" type="log4net.Config.Log4NetConfigurationSectionHandler, log4net"/>
4
  </configSections>
5

6
  <log4net>
7
    <appender name="RollingFileAppender" type="log4net.Appender.RollingFileAppender">
8
      <file value="Logs/AppLog.txt"/>
9
      <appendToFile value="true"/>
10
      <rollingStyle value="Size"/>
11
      <maxSizeRollBackups value="10"/>
12
      <maximumFileSize value="5MB"/>
13
      <staticLogFileName value="true"/>
14
      <layout type="log4net.Layout.PatternLayout">
15
        <conversionPattern value="%date [%thread] %-5level %logger - %message%newline" />
16
      </layout>
17
    </appender>
18

19
    <root>
20
      <level value="DEBUG"/>
21
      <appender-ref ref="RollingFileAppender"/>
22
    </root>
23
  </log4net>
24
</configuration>

第二步：启动配置监视#

在项目的 Properties/AssemblyInfo.cs 中添加以下特性，确保配置自动加载：

1
[assembly: log4net.Config.XmlConfigurator(Watch = true)]

第三步：WPF 生命周期中的日志埋点#

在 App.xaml.cs 中记录生命周期，这是追踪程序“是否正常关闭”的关键：

1
public partial class App : Application
2
{
3
    private static readonly ILog Log = LogManager.GetLogger(typeof(App));
4

5
    protected override void OnStartup(StartupEventArgs e)
6
    {
7
        Log.Info("================ 应用启动 ================");
8
        base.OnStartup(e);
9

10
        // 进阶：配置全局异常捕获
11
        SetupExceptionHandling();
12
    }
13

14
    private void SetupExceptionHandling()
15
    {
16
        // 捕获 UI 线程异常
17
        this.DispatcherUnhandledException += (s, e) => {
18
            Log.Fatal("UI线程未捕获异常", e.Exception);
19
            e.Handled = true;
20
        };
21
    }
22

23
    protected override void OnExit(ExitEventArgs e)
24
    {
25
        Log.Info("================ 应用退出 ================");
26
        base.OnExit(e);
27
    }
28
}

第四步：业务逻辑中的调用#

建议使用静态声明的方式引用 Logger，避免每次调用都重复获取，提高性能：

1
public partial class MainWindow : Window
2
{
3
    // 获取当前类的记录器
4
    private static readonly ILog Log = LogManager.GetLogger(System.Reflection.MethodBase.GetCurrentMethod().DeclaringType);
5

6
    public MainWindow()
7
    {
8
        InitializeComponent();
9
    }
10

11
    private void LogBtn_Click(object sender, RoutedEventArgs e)
12
    {
13
        try
14
        {
15
            Log.Debug("点击了创建日志按钮");
16
            // 模拟业务逻辑
17
        }
18
        catch (Exception ex)
19
        {
20
            Log.Error("处理点击事件时发生异常", ex);
21
        }
22
    }
23
}

💡 核心知识点：日志级别的选型#

Log4net 的级别是由低到高过滤的。如果你设置级别为 INFO，那么 DEBUG 信息将不会被记录。

DEBUG: 内部调试细节（开发期使用）。
INFO: 关键业务流程（用户登录、开始下载、完成支付）。
WARN: 异常但可自动修复的情况（网络瞬时抖动、配置项缺失使用默认值）。
ERROR: 业务失败但程序不崩溃（数据保存失败、图片加载404）。
FATAL: 毁灭性打击（数据库连接失败、内存溢出），通常伴随程序闪退。

总结#

通过在 WPF 中集成 Log4net，你可以轻松实现：

自动切割：日志文件不会撑爆硬盘。
多级过滤：开发环境看 Debug，生产环境看 Info。
全链路追踪：配合全局异常捕获，告别“用户反馈闪退，开发者无从查起”的尴尬局面。