FileSystemWatcher是C#中用于实时监控文件系统变化的核心类，支持创建、修改、删除、重命名等事件响应，适用于日志监控、配置热加载等场景，需注意缓冲区溢出、事件重复触发及权限等问题。
在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 功能强大但使用时要注意稳定性和边界情况。合理配置参数并做好异常处理，能让你的文件监控更可靠。