Node.js循环读取多文件时返回[object Promise]问题求解

问题根源 #

你直接将异步读取文件返回的Promise对象拼接到字符串中，而非等待Promise完成后获取实际文件内容；同时普通循环（如forEach/map）不会等待异步操作执行完毕，导致markup先被输出，文件内容的日志后出现，最终markup变成[object Promise][object Promise]。

修复方案 #

方案1：使用for...of顺序读取（推荐，严格保证顺序） #

通过for...of循环遍历文件列表，逐个await文件读取操作，确保每一步都拿到实际内容后再拼接：

import fs from 'fs/promises';
import path from 'path';

async function generateTOC() {
  // 替换成你的实际文件列表
  const files = ['path/to/file1.md', 'path/to/file2.md'];
  let markup = '';

  for (const file of files) {
    const filePath = path.resolve(__dirname, file);
    // 等待文件读取完成，拿到实际内容
    const content = await fs.readFile(filePath, 'utf8');
    markup += content;
    console.log('已读取文件内容:', content);
  }

  console.log('最终拼接结果:', markup);
  return markup;
}

// 执行函数并捕获错误
generateTOC().catch(err => console.error('生成TOC失败:', err));

方案2：使用Promise.all并行读取（若无需严格顺序） #

如果文件读取顺序不影响最终拼接结果，可并行读取所有文件后再拼接，效率更高：

import fs from 'fs/promises';
import path from 'path';

async function generateTOC() {
  const files = ['path/to/file1.md', 'path/to/file2.md'];
  // 生成所有文件读取的Promise数组
  const contentPromises = files.map(file => {
    const filePath = path.resolve(__dirname, file);
    return fs.readFile(filePath, 'utf8');
  });

  // 等待所有Promise完成，拿到所有文件内容数组
  const contents = await Promise.all(contentPromises);
  // 拼接所有内容
  const markup = contents.join('');

  console.log('最终拼接结果:', markup);
  return markup;
}

generateTOC().catch(err => console.error('生成TOC失败:', err));

为什么之前的方法失效？ #

• 若你使用forEach循环，循环内部的await不会阻塞循环本身，每个fs.readFile都会立即返回Promise对象并直接拼到markup中，导致markup变成多个Promise对象的字符串形式。
• 异步操作的执行顺序晚于同步代码，所以markup的日志会先于文件内容的日志输出。

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