Git操作修改本地仓库文件未触发FileWatcher的问题咨询

• Git采用原子操作执行文件变更：执行git restore、git checkout等操作时，Git不会直接修改工作区的目标文件，而是先在.git隐藏目录下生成临时文件，操作验证完成后通过原子重命名替换的方式覆盖目标文件。默认配置的FileSystemWatcher通常仅监听LastWrite类普通修改事件，未监听重命名、文件名变更类事件，因此无法捕获这类原子替换操作。
• 过滤规则误拦截：多数开发者初始化FileSystemWatcher时会配置过滤隐藏文件/目录的规则，Git操作产生的临时文件归属.git隐藏目录，相关变更事件会被提前过滤。
• 缓冲区溢出丢事件：Git操作经常会在极短时间内触发数十上百个文件变更事件，FileSystemWatcher默认缓冲区仅为4KB，事件量超过缓冲区上限后，新产生的事件会被系统直接丢弃。

• 显式配置完整的监听事件类型，覆盖Git原子操作产生的变更：

// 初始化时添加所有需要的监听维度
watcher.NotifyFilter = NotifyFilters.LastWrite 
                        | NotifyFilters.FileName 
                        | NotifyFilters.DirectoryName 
                        | NotifyFilters.Size 
                        | NotifyFilters.Attributes;

• 取消全局隐藏文件过滤规则：不要在初始化阶段直接过滤隐藏项，改为在事件回调中手动判断路径是否包含.git目录，过滤掉Git内部目录的无效事件即可，避免拦截工作区文件的替换事件。
• 调大内部缓冲区容量，最大支持设置为64KB，降低溢出概率：

watcher.InternalBufferSize = 65536;

• 单独监听重命名事件，处理Git原子替换场景：

watcher.Renamed += (sender, e) =>
{
    // 仅处理目标路径属于监听范围的重命名事件
    if (IsTargetMonitorPath(e.FullPath))
    {
        // 执行你的业务逻辑
    }
};

• 新增兜底定时扫描逻辑：如果上述配置仍存在漏触发场景，可每隔10~30秒对监听目录的目标文件做一次修改时间/哈希值全量对比，补全漏报的变更事件。

内容的提问来源于stack exchange，提问作者RollRoll