在C#中，如果你需要监控文件或目录的变化，比如文件的创建、修改、重命名或删除，FileSystemWatcher 是一个非常实用的类。它位于 System.IO 命名空间下，能够让你实时响应文件系统的变动，适用于日志监控、配置文件自动加载、数据同步等场景。
基本用法
使用 FileSystemWatcher 很简单，只需要指定要监视的路径和需要关注的事件类型即可。
示例：监控某个目录下的文本文件修改
using System;
using System.IO;
class Program
{
static void Main()
{
// 创建监视器实例
FileSystemWatcher watcher = new FileSystemWatcher();
// 设置监视的目录
watcher.Path = @"C:\logs";
// 可选：设置过滤条件（只监听 .txt 文件）
watcher.Filter = "*.txt";
// 指定要监视的更改类型
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("正在监视目录... 按任意键退出。");
Console.ReadKey();
}
private static void OnChanged(object source, FileSystemEventArgs e)
{
Console.WriteLine($"文件 {e.FullPath} 被修改了！");
}
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}");
}
}
关键属性说明
Path：要监视的目录路径。注意只能监视本地目录，不能监视网络路径（除非映射为本地盘符）。 Filter：过滤文件名，支持通配符如 "*.txt" 或 "log?.log"。 IncludeSubdirectories：是否递归监视子目录，默认 false。 NotifyFilter：指定检测哪些类型的更改，例如文件大小、创建时间、文件名等。 EnableRaisingEvents：设为 true 才会开始触发事件。常见问题与注意事项
事件重复触发：在某些操作（如保存文件）中，操作系统可能会引发多个事件。建议在处理逻辑中加入去重或延迟合并机制。 缓冲区溢出：如果事件产生太快，可能造成内部缓冲区溢出，导致丢失事件。可通过设置 InternalBufferSize 属性增大缓冲区（默认 8KB，最大 64KB）。 跨平台兼容性：在 Linux 或 macOS 上使用 .NET Core/.NET 5+ 时，FileSystemWatcher 依赖底层系统 API，行为可能略有差异。 权限要求：运行程序的账户必须对目标目录有读取和监视权限。 资源释放：使用完后应调用 Dispose() 方法释放句柄，避免资源泄漏。高级技巧
结合 Debounce 机制防抖动：例如用户保存文件时连续触发多次 Changed，可用 Timer 合并处理。 动态调整监视路径或过滤条件：可在运行时修改 Filter 或 Path 并重新启用事件。 配合后台服务使用：将 FileSystemWatcher 集成到 Windows Service 或 ASP.NET Core HostedService 中实现长期监控。基本上就这些。FileSystemWatcher 功能强大但使用时要注意稳定性和边界情况。合理配置参数并做好异常处理，能让你的文件监控更可靠。
