.NET 中实现对文件夹的监听，最常用的方式是使用 FileSystemWatcher 类。它位于 System.IO 命名空间下，能够监控指定目录中的文件或子目录的创建、删除、修改、重命名等操作。
1. 基本用法：设置 FileSystemWatcher
下面是一个简单的示例，展示如何监听某个文件夹的变更：
using System;
using System.IO;
class Program
{
static void Main()
{
// 创建 FileSystemWatcher 实例
using (var watcher = new FileSystemWatcher())
{
watcher.Path = @"C:example"; // 要监听的文件夹路径
// 可选：监听哪些类型的文件（如 *.txt）
watcher.Filter = "*.*";
// 监听子目录
watcher.IncludeSubdirectories = true;
// 设置要监听的事件类型
watcher.NotifyFilter = NotifyFilters.LastWrite
| NotifyFilters.FileName
| NotifyFilters.DirectoryName;
// 绑定事件处理程序
watcher.Changed += OnChanged;
watcher.Created += OnCreated;
watcher.Deleted += OnDeleted;
watcher.Renamed += OnRenamed;
// 开始监听
watcher.EnableRaisingEvents = true;
Console.WriteLine("正在监听 C:\example 目录，请按 Enter 键退出...");
Console.ReadLine();
}
}
private static void OnChanged(object source, FileSystemEventArgs e)
{
Console.WriteLine($"文件 {e.FullPath} 被修改 ({e.ChangeType})");
}
private static void OnCreated(object source, FileSystemEventArgs e)
{
Console.WriteLine($"文件 {e.FullPath} 被创建");
}
private static void OnDeleted(object source, FileSystemEventArgs e)
{
Console.WriteLine($"文件 {e.FullPath} 被删除");
}
private static void OnRenamed(object source, RenamedEventArgs e)
{
Console.WriteLine($"文件从 {e.OldFullPath} 重命名为 {e.FullPath}");
}
}
2. 注意事项和常见问题
虽然 FileSystemWatcher 使用简单，但实际使用中需要注意以下几点：
事件触发频率高：例如文本编辑器保存文件时可能触发多次 Changed 事件，建议加入防抖逻辑（如延迟处理）避免重复执行。 缓冲区溢出：在大量文件变动时，内部缓冲区可能溢出导致丢失事件。可通过增大 InternalBufferSize 属性缓解（默认 8KB，最大 64KB）。 路径必须存在：监听的目录必须在启动前存在，否则会抛出异常。 权限问题：运行程序需要有访问目标目录的权限。 网络路径不稳定：监听网络共享文件夹时可能不灵敏，建议在本地部署服务。3. 高级技巧：去重与异步处理
为避免短时间内重复触发，可以加一个简单的延迟去重机制：
private static readonly Dictionary<string, Timer> _pendingChanges = new();
private static void OnChanged(object source, FileSystemEventArgs e)
{
if (_pendingChanges.TryGetValue(e.FullPath, out var timer))
{
timer.Dispose();
}
_pendingChanges[e.FullPath] = new Timer(DoActualProcessing, e.FullPath, 2000, Timeout.Infinite);
}
private static void DoActualProcessing(object state)
{
string path = (string)state;
Console.WriteLine($"处理文件变更: {path}");
_pendingChanges.Remove(path);
}
这样可以确保每个文件在最后一次修改后 2 秒再执行具体逻辑，适合日志写入、文件上传等场景。
基本上就这些。FileSystemWatcher 是 .NET 中监听文件夹变化的标准方式，合理配置后可稳定用于生产环境。
