在.NET跨平台开发场景下，实现Linux和macOS系统的文件系统监控可以借助内置的FileSystemWatcher类，该类会根据不同操作系统的底层特性自动选择对应的监控实现，无需开发者手动适配不同系统的底层接口。
FileSystemWatcher的跨平台底层实现
FileSystemWatcher在Windows系统上基于ReadDirectoryChangesW实现，在Linux系统上会调用inotify接口，在macOS系统上则会使用FSEvents框架。这些底层机制都是对应系统原生提供的文件监控能力，能够保证监控的实时性和可靠性。
核心监控事件类型
FileSystemWatcher支持监控的文件变动事件包含以下几类：
- Created：文件或目录被创建时触发
- Changed：文件或目录内容被修改时触发
- Deleted：文件或目录被删除时触发
- Renamed：文件或目录被重命名时触发
- Error：监控过程中出现错误时触发
Linux/macOS环境的基础使用示例
首先需要在项目中引入System.IO命名空间，然后初始化FileSystemWatcher实例并配置监控路径和事件。
基础监控代码实现
以下是一个简单的文件监控示例，监控指定目录下的所有文件变动：
using System;
using System.IO;
class FileMonitorService
{
static void Main(string[] args)
{
// 监控的目录路径，Linux/macOS下使用绝对路径或相对路径均可
string watchPath = "/home/test/watch_dir";
// 初始化FileSystemWatcher实例
using (FileSystemWatcher watcher = new FileSystemWatcher())
{
// 设置监控路径
watcher.Path = watchPath;
// 监控所有类型的文件，也可以指定具体后缀，比如*.txt
watcher.Filter = "*.*";
// 是否监控子目录
watcher.IncludeSubdirectories = true;
// 设置需要监控的变动类型
watcher.NotifyFilter = NotifyFilters.FileName
| NotifyFilters.DirectoryName
| NotifyFilters.LastWrite;
// 绑定各类事件处理函数
watcher.Created += OnFileCreated;
watcher.Changed += OnFileChanged;
watcher.Deleted += OnFileDeleted;
watcher.Renamed += OnFileRenamed;
watcher.Error += OnMonitorError;
// 开启监控
watcher.EnableRaisingEvents = true;
Console.WriteLine($"开始监控目录：{watchPath}");
Console.WriteLine("按任意键退出监控...");
Console.ReadKey();
}
}
// 文件创建事件处理
private static void OnFileCreated(object sender, FileSystemEventArgs e)
{
Console.WriteLine($"文件创建：{e.FullPath}，变动类型：{e.ChangeType}");
}
// 文件修改事件处理
private static void OnFileChanged(object sender, FileSystemEventArgs e)
{
Console.WriteLine($"文件修改：{e.FullPath}，变动类型：{e.ChangeType}");
}
// 文件删除事件处理
private static void OnFileDeleted(object sender, FileSystemEventArgs e)
{
Console.WriteLine($"文件删除：{e.FullPath}，变动类型：{e.ChangeType}");
}
// 文件重命名事件处理
private static void OnFileRenamed(object sender, RenamedEventArgs e)
{
Console.WriteLine($"文件重命名：旧路径{e.OldFullPath}，新路径{e.FullPath}");
}
// 监控错误处理
private static void OnMonitorError(object sender, ErrorEventArgs e)
{
Console.WriteLine($"监控出现错误：{e.GetException().Message}");
}
}
Linux/macOS平台使用注意事项
路径格式适配
Linux和macOS系统使用正斜杠/作为路径分隔符，和Windows的反斜杠不同，代码中如果涉及路径拼接，建议使用Path.Combine方法，避免硬编码路径分隔符导致跨平台兼容问题。
权限配置要求
运行监控程序的用户需要对监控的目录拥有读取权限，否则无法触发对应的监控事件。如果监控系统目录，可能需要使用root权限运行程序。
inotify资源限制
Linux系统下inotify有默认的资源限制，如果监控的目录和文件数量过多，可能会出现监控失效的情况，可以通过修改/etc/sysctl.conf文件调整以下参数：
- fs.inotify.max_user_instances：单个用户可创建的inotify实例数，默认128
- fs.inotify.max_user_watches：单个用户可监控的文件数量，默认8192
修改完成后执行sysctl -p命令使配置生效。
事件去重处理
在Linux和macOS系统上，部分文件操作可能会触发多次相同事件，比如一次文件写入可能同时触发Changed和Created事件，实际开发中需要对事件做去重处理，避免重复执行业务逻辑。
高级配置参数说明
FileSystemWatcher提供了多个可配置参数，适配不同的监控需求：
| 参数名称 | 说明 | 默认值 |
|---|---|---|
| EnableRaisingEvents | 是否开启监控，只有设置为true才会触发事件 | false |
| IncludeSubdirectories | 是否监控子目录下的文件变动 | false |
| Filter | 监控的文件过滤规则，支持通配符，比如*.log | *.* |
| NotifyFilter | 指定需要监控的变动类型，可组合多个值 | LastWrite, FileName, DirectoryName |
| InternalBufferSize | 内部缓冲区大小，文件变动频繁时可以适当调大 | 8192字节 |
常见问题排查
如果监控没有正常触发事件，可以按照以下步骤排查：
- 检查监控路径是否存在，路径是否正确
- 确认EnableRaisingEvents是否已经设置为true
- 检查运行程序的用户是否有监控目录的访问权限
- Linux系统下检查inotify的相关资源限制是否足够
- 确认绑定的事件处理函数是否正确注册
通过上述配置和使用方式，就可以在Linux和macOS系统上基于.NET的FileSystemWatcher实现稳定的底层文件监控功能，满足大多数跨平台文件变动感知的需求。
C#FileSystemWatcher.NETLinux_file_monitormacOS_file_monitor修改时间：2026-06-22 03:43:06