.NET中监听文件夹最常用FileSystemWatcher类,位于System.IO命名空间,可监控指定目录的文件或子目录的创建、删除、修改和重命名操作。1. 基本用法:通过设置Path属性指定监听路径,Filter过滤文件类型,IncludeSubdirectories决定是否监听子目录,NotifyFilter定义监听事件类型,并绑定Changed、Created、Deleted、Renamed等事件处理程序,最后启用EnableRaisingEvents开始监听。2. 注意事项:需确保监听路径存在且程序有访问权限;避免因文本编辑器频繁保存导致事件触发过多,建议加入防抖机制;大量文件变动可能引发缓冲区溢出,可通过增大InternalBufferSize缓解(默认8KB,最大64KB);网络路径监听不稳定,推荐本地部署。3. 高级技巧:使用Dictionary结合Timer实现延迟去重处理,防止短时间内重复执行,例如每个文件在最后一次修改2秒后才触发实际逻辑,适用于日志写入或文件上传场景。合理配置下,FileSystemWatcher可稳定用于生产环境。

.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_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 中监听文件夹变化的标准方式,合理配置后可稳定用于生产环境。










