Node.js遍历文件时fs.stat存入数组的异步问题求助

兄弟，你完全戳中了问题的要害——就是异步操作的执行顺序在搞事情！for循环是同步代码，会以极快的速度跑完所有迭代，而fs.stat是异步IO操作，它的回调要等磁盘IO完成后才会触发。等回调真正执行的时候，循环早就结束了，你后续去访问data数组自然是空的。

下面给你几种用Promise+async/await解决的方案，都是现在Node.js里常用的写法：

方案1：自己封装Promise版的fs.stat（兼容旧版Node.js） #

如果你的Node.js版本低于10，可以手动把回调式的fs.stat封装成Promise，再配合async/await控制流程：

const fs = require('fs');
const path = require('path');

// 把fs.stat包装成Promise
function getFileStats(filePath) {
  return new Promise((resolve, reject) => {
    fs.stat(filePath, (error, stats) => {
      if (error) reject(error);
      else resolve(stats);
    });
  });
}

// 异步遍历目录的主函数
async function collectFileDetails(dirPath) {
  const data = [];
  // 先同步读取目录下的文件列表（也可以用Promise版readdir）
  const files = fs.readdirSync(dirPath);

  // 用for...of循环配合await，让每一次迭代都等stat完成
  for (const fileName of files) {
    const fullFilePath = path.join(dirPath, fileName);
    try {
      const stats = await getFileStats(fullFilePath);
      // 这里的push会在stat完成后执行，确保数据被正确存入
      data.push({
        name: fileName,
        fullPath: fullFilePath,
        createTime: stats.birthtime,
        modifyTime: stats.mtime,
        size: stats.size
      });
    } catch (err) {
      console.error(`获取文件${fileName}信息失败:`, err);
    }
  }

  return data;
}

// 调用示例
collectFileDetails('./target-dir')
  .then(result => {
    console.log('完整的文件详情数组:', result);
    // 在这里处理你的data数组就行
  })
  .catch(err => console.error('遍历出错:', err));

方案2：直接用fs.promises（Node.js 10+推荐） #

从Node.js 10开始，fs模块原生提供了Promise版本的API，不用自己封装，代码更简洁：

const fs = require('fs').promises;
const path = require('path');

async function collectFileDetails(dirPath) {
  const data = [];
  const files = await fs.readdir(dirPath);

  for (const fileName of files) {
    const fullFilePath = path.join(dirPath, fileName);
    try {
      const stats = await fs.stat(fullFilePath);
      data.push({
        name: fileName,
        fullPath: fullFilePath,
        createTime: stats.birthtime,
        modifyTime: stats.mtime,
        size: stats.size
      });
    } catch (err) {
      console.error(`获取文件${fileName}信息失败:`, err);
    }
  }

  return data;
}

// 调用方式一样
collectFileDetails('./target-dir')
  .then(result => console.log(result))
  .catch(err => console.error(err));

方案3：并行处理（更快的遍历速度） #

如果想让所有文件的stat请求同时发起（适合文件数量不多的场景，速度更快），可以用Promise.all：

const fs = require('fs').promises;
const path = require('path');

async function collectFileDetailsParallel(dirPath) {
  const files = await fs.readdir(dirPath);
  // 生成所有文件的stat Promise数组
  const fileDetailPromises = files.map(async fileName => {
    const fullFilePath = path.join(dirPath, fileName);
    const stats = await fs.stat(fullFilePath);
    return {
      name: fileName,
      fullPath: fullFilePath,
      createTime: stats.birthtime,
      modifyTime: stats.mtime,
      size: stats.size
    };
  });

  // 等待所有Promise完成，直接得到完整的data数组
  const data = await Promise.all(fileDetailPromises);
  return data;
}

// 调用示例
collectFileDetailsParallel('./target-dir')
  .then(result => console.log(result))
  .catch(err => console.error(err));

核心原理 #

await会暂停当前async函数的执行，直到对应的Promise状态变为resolved，这样就把异步操作“同步化”到了循环流程里，确保每一次data.push都在fs.stat完成后执行，自然就能正确填充数组了。

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