Node.js异步内部函数无法向外部数组添加数据，返回空数组求解

问题根源 #

你碰到的空数组问题，核心是异步操作的执行顺序没处理对——你在所有fs.readFile的异步读取完成前，就返回了projects数组，这时候数组还没被填充数据，自然是空的。

正确实现方式 #

用fs/promises结合async/await是最清晰的解决办法，之前没成功大概率是没处理好异步遍历的逻辑，下面是可运行的代码：

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

// 定义异步函数
async function getProjects() {
  const projects = [];
  // 先读取项目目录下的所有文件夹
  const folders = await fs.readdir('./projects');

  // 用for...of遍历，确保每个异步读取都完成后再继续
  for (const folder of folders) {
    const jsonPath = path.join('./projects', folder, 'project.json');
    // 读取并解析json文件
    const jsonContent = await fs.readFile(jsonPath, 'utf8');
    projects.push(JSON.parse(jsonContent));
  }

  // 如果想提高效率，也可以用Promise.all并行处理所有读取操作
  // const projects = await Promise.all(folders.map(async folder => {
  //   const jsonPath = path.join('./projects', folder, 'project.json');
  //   const content = await fs.readFile(jsonPath, 'utf8');
  //   return JSON.parse(content);
  // }));

  return projects;
}

// 调用异步函数时，必须用await或者.then获取结果
getProjects()
  .then(projects => console.log('项目数据：', projects))
  .catch(err => console.error('读取失败：', err));

为什么之前的尝试没解决问题 #

• 用扩展运算符替代push：本质还是没等异步操作完成就返回数组，和用什么方法添加元素无关
• 转为类用this：同样没处理异步执行顺序，this.projects在异步读取完成前就被访问了
• 用fs/promises但没配合async/await：如果只是用了Promise但同步返回数组，或者用forEach遍历（forEach不支持等待异步函数完成），还是会拿到空数组

关键注意点 #

• 异步操作必须等待完成后才能访问结果，async/await或Promise.all是管理异步流程的核心
• 不要用forEach遍历异步任务，它不会等待每个异步操作完成，改用for...of或Promise.all
• 调用异步函数时，必须通过await或.then()来获取最终结果，不能直接同步返回

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