为何Node.js fs.stat()在文件变更时不更新file.mtime？

我在Windows环境下用Node.js做文件监控时也踩过类似的坑，结合你提到的场景（Node.js v8.10.0 + Windows10），给你梳理下问题原因和可行的解决办法：

这本质是Windows文件系统的元数据更新机制和Node.js旧版本API的局限性导致的：

• 有些应用写入文件时会利用系统缓存，不会立刻把文件元数据（比如mtime）刷新到磁盘，只有当应用显式调用刷新接口或者缓存满了才会更新，这就出现了size变但mtime不变的情况；
• 像Sublime、Notepad++这类编辑器，保存文件时通常是直接重写文件或者显式触发了元数据刷新，所以mtime会正常更新；
• Node.js v8.x的fs.watch在Windows上基于ReadDirectoryChangesW API实现，小变更如果停留在缓存里没同步到磁盘，就不会触发监控事件。

1. 双重校验：结合文件size+内容片段判断 #

既然mtime不可靠，我们可以用size变化作为初步判断，再通过读取文件的部分内容（比如最后几KB）来确认内容是否真的更新，避免误判：

const fs = require('fs');
const targetFile = '你的日志文件.log';
let lastRecordedSize = 0;
let lastContentSnapshot = '';

function checkFileChanges() {
  fs.stat(targetFile, (err, stats) => {
    if (err) {
      console.error('获取文件状态失败:', err);
      return;
    }

    // 先判断文件大小是否变化
    if (stats.size !== lastRecordedSize) {
      // 读取文件最后1KB内容做快照对比
      const buffer = Buffer.alloc(1024);
      fs.open(targetFile, 'r', (err, fd) => {
        if (err) return;
        // 从文件末尾倒数1KB的位置读取
        const readPosition = Math.max(0, stats.size - 1024);
        fs.read(fd, buffer, 0, 1024, readPosition, (err, bytesRead) => {
          fs.close(fd);
          if (err) return;

          const currentSnapshot = buffer.toString('utf8', 0, bytesRead);
          if (currentSnapshot !== lastContentSnapshot) {
            console.log('检测到文件内容更新！');
            lastRecordedSize = stats.size;
            lastContentSnapshot = currentSnapshot;
          }
        });
      });
    }
  });
}

// 每隔2秒检查一次
setInterval(checkFileChanges, 2000);

2. 改用fs.watchFile替代手动轮询 #

fs.watchFile是Node.js内置的轮询式监控，比你手动写setInterval + fs.stat更稳定，它会自动对比文件的状态变化，还能配置轮询频率：

const fs = require('fs');
const targetFile = '你的日志文件.log';

// 配置每隔2秒轮询一次
fs.watchFile(targetFile, { interval: 2000 }, (currentStats, previousStats) => {
  // 同时判断size和mtime的变化，或者直接对比两个stats对象
  if (currentStats.size !== previousStats.size || currentStats.mtime.getTime() !== previousStats.mtime.getTime()) {
    console.log('文件已发生变更');
  }
});

3. 优化写入端的元数据刷新（如果可控） #

如果写入文件的应用是你自己开发的，在写入完成后调用fs.fsync()或者fs.fdatasync()强制刷新文件元数据到磁盘，这样mtime就会立刻更新：

const fs = require('fs');
const targetFile = '你的日志文件.log';

fs.open(targetFile, 'a', (err, fd) => {
  if (err) {
    console.error('打开文件失败:', err);
    return;
  }

  fs.write(fd, '新增的日志内容\n', (err) => {
    if (err) {
      fs.close(fd);
      console.error('写入文件失败:', err);
      return;
    }

    // 强制刷新文件元数据到磁盘
    fs.fsync(fd, (err) => {
      fs.close(fd);
      if (err) console.error('刷新元数据失败:', err);
    });
  });
});

4. 升级Node.js版本（推荐） #

Node.js v8.10.0是比较老旧的版本了，后续的LTS版本（比如14.x、16.x）对Windows文件系统的监控逻辑做了很多优化，能大幅减少这类元数据不同步的问题，建议升级到稳定的新版本。

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