filesystemwatcher可监控创建、删除、重命名和内容修改，但changed事件不保证捕获每次保存（如vs code原子替换导致created+deleted）；需显式设置notifyfilter并规避初始化触发；网络路径支持差，需轮询等替代方案；事件在后台线程触发，ui更新须调度；务必dispose释放资源。
FileSystemWatcher 能监控哪些变化
它能捕获文件或子目录的创建、删除、重命名和内容修改，但要注意：Changed 事件默认只响应最后写入时间（LastWrite）或属性变更，**不保证每次文件保存都触发**——比如某些编辑器（VS Code、Notepad++）会先写临时文件再原子替换，此时你看到的是 Created + Deleted，而不是 Changed。
实际使用中建议至少订阅这四个事件：Created、Deleted、Renamed、Changed，并配合 NotifyFilter 显式指定关注维度：
-
NotifyFilter.LastWrite：捕获内容修改（最常用） -
NotifyFilter.FileName | NotifyFilter.DirectoryName：支持重命名检测 -
NotifyFilter.Attributes：如只读/隐藏位变化
为什么刚启动就收到一堆 Changed 事件
默认情况下 FileSystemWatcher 会递归扫描初始状态，把已存在的文件当作“刚被修改”来触发 Changed。这不是 bug，是设计行为。
避免方法很简单：在调用 EnableRaisingEvents = true 之前，先完成事件注册；更稳妥的做法是加一个初始化标记：
var watcher = new FileSystemWatcher(@"C:\target");
watcher.IncludeSubdirectories = true;
watcher.NotifyFilter = NotifyFilter.LastWrite | NotifyFilter.FileName | NotifyFilter.DirectoryName;
// 先注册事件，再启用
watcher.Changed += OnChanged;
watcher.Created += OnCreated;
// ...其他事件
watcher.EnableRaisingEvents = false; // 暂不启用
bool isInitialized = false;
watcher.EnableRaisingEvents = true;
isInitialized = true; // 启用后再设标志
void OnChanged(object sender, FileSystemEventArgs e) {
if (!isInitialized) return; // 跳过初始化扫描产生的事件
// 正常处理逻辑
}
监听网络路径或 OneDrive 同步文件夹时失效
FileSystemWatcher 依赖 Windows API 的底层通知机制（ReadDirectoryChangesW），对 SMB 共享、OneDrive、Google Drive 等云同步目录支持极差——常见现象是事件完全不触发，或延迟高达数分钟。
原因很直接：这些路径不是本地 NTFS 卷，底层驱动无法可靠投递变更通知。
替代方案有限，但可考虑：
- 改用轮询：
Directory.GetFiles()+FileInfo.LastWriteTime对比（适合低频、小目录） - 用
Microsoft.Win32.SafeHandles.SafeFileHandle手动调用ReadDirectoryChangesW（复杂且仍受限） - 换工具：如
Microsoft.Extensions.FileSystemGlobbing配合定时扫描，或引入第三方库如Alphaleonis.Win32.Filesystem（增强网络路径兼容性）
事件回调线程不是 UI 线程，也不能直接更新 WinForms/WPF 控件
FileSystemWatcher 的所有事件都在后台线程（IOCP 线程池）中触发，如果直接操作 TextBox.Text 或 ListBox.Items.Add()，会抛出 InvalidOperationException: “线程间操作无效”。
WinForms 下必须用 Control.Invoke() 或 BeginInvoke()；WPF 下要用 Dispatcher.Invoke()：
// WinForms 示例
private void OnCreated(object sender, FileSystemEventArgs e) {
if (this.InvokeRequired) {
this.Invoke((MethodInvoker)(() => UpdateLog(e.FullPath)));
} else {
UpdateLog(e.FullPath);
}
}
// WPF 示例
private void OnCreated(object sender, FileSystemEventArgs e) {
this.Dispatcher.Invoke(() => UpdateLog(e.FullPath));
}
别忘了在窗体关闭前调用 watcher.Dispose()，否则可能引发资源泄漏或程序退出卡死——这是最容易被跳过的一步。
