C#实现文件变化监听FileSystemWatcher类详解

来源：足球分析预测网类型：技术文章发布：2026-07-01 17:07:53

在现代软件开发中，文件系统的实时监控是一项常见且重要的功能。无论是日志文件的动态读取、配置文件的自动重载，还是文件夹同步工具的开发，都需要程序能够及时感知文件或目录的变化。在.NET框架中，FileSystemWatcher类为我们提供了一个强大而高效的解决方案，用于监听指定目录中的文件创建、修改、删除和重命名等操作。本文将深入解析FileSystemWatcher类的核心机制、使用方法及注意事项，帮助开发者高效实现文件变化监听功能。

一、FileSystemWatcher类的基本原理

FileSystemWatcher是System.IO命名空间下的一个组件，它通过操作系统底层的文件系统通知机制（如Windows的ReadDirectoryChangesW API）来监听目录或文件的变化。当被监听的路径发生指定类型的变更时，FileSystemWatcher会触发相应的事件，开发者可通过注册事件处理程序来响应这些变化。

该类支持监听以下四种主要事件：

Created：文件或目录被创建时触发。
Changed：文件或目录被修改时触发（如内容更改、属性变更等）。
Deleted：文件或目录被删除时触发。
Renamed：文件或目录被重命名时触发。

二、核心属性与配置

在使用FileSystemWatcher前，需正确配置其关键属性：

Path：指定要监听的目录路径，是必填项。
Filter：设置监听的文件类型，如*.txt仅监听文本文件，默认为*.*（所有文件）。
IncludeSubdirectories：布尔值，决定是否递归监听子目录。
NotifyFilter：指定监听的变化类型，如NotifyFilters.LastWrite（内容修改）、NotifyFilters.FileName（文件名更改）等，可组合使用。
EnableRaisingEvents：控制是否开始监听，设为true时启动监听。

合理配置这些属性，可以精准控制监听范围，避免不必要的性能开销。

三、事件处理与代码实现

以下是使用FileSystemWatcher监听文件夹中TXT文件变化的示例代码：

using System;
using System.IO;

class Program
{
    static void Main()
    {
        var watcher = new FileSystemWatcher
        {
            Path = @"C:\MyFolder",
            Filter = "*.txt",
            IncludeSubdirectories = false,
            NotifyFilter = NotifyFilters.FileName | NotifyFilters.LastWrite
        };

        watcher.Created += OnChanged;
        watcher.Changed += OnChanged;
        watcher.Deleted += OnChanged;
        watcher.Renamed += OnRenamed;

        watcher.EnableRaisingEvents = true;

        Console.WriteLine("正在监听文件夹，按回车键退出...");
        Console.ReadLine();
    }

    private static void OnChanged(object sender, FileSystemEventArgs e)
    {
        Console.WriteLine($"文件 {e.FullPath} 被 {e.ChangeType}");
    }

    private static void OnRenamed(object sender, RenamedEventArgs e)
    {
        Console.WriteLine($"文件 {e.OldFullPath} 重命名为 {e.FullPath}");
    }
}

该程序会实时输出文件的创建、修改、删除和重命名操作，便于后续业务逻辑处理。

四、注意事项与最佳实践

尽管FileSystemWatcher功能强大，但在使用时需注意以下几点：

事件可能丢失：在高频率文件操作场景下，系统缓冲区可能溢出，导致事件丢失。可通过增大InternalBufferSize（默认8KB）缓解，但无法完全避免。
Changed事件频繁触发：文件保存时可能触发多次Changed事件。建议结合定时器或文件哈希校验进行去重处理。
权限问题：确保程序有足够权限访问目标目录，否则会抛出异常。
网络路径监听：监听网络共享目录时，稳定性较差，建议谨慎使用。