如何在Node.js中读取数组内文件并检索关键字输出对应路径

原有代码缺陷说明 #

• 路径数组未区分文件/目录类型：fs.readFile 仅支持读取普通文件，传入目录路径时会直接触发读取失败
• 逻辑返回值偏离需求：匹配到关键字时返回值存入的是文件内容，而非当前文件的完整路径；未命中关键字时对应Promise无resolve/reject返回，造成异步流程永久阻塞
• 异步流程控制失效：forEach 的回调是普通同步执行函数，内部写的await不会被外层run函数等待，循环内的异步操作无法完成串行阻塞
• 异常捕获位置无效：try块包裹的是Promise构造器的同步执行阶段，无法捕获fs.readFile异步回调内抛出的异常

修正后完整可运行代码 #

直接使用Node.js内置的Promise版fs接口，省去手动封装Promise的冗余逻辑，按路径类型判断、内容匹配、结果收集的流程实现需求：

// 引入Promise版本的fs与path模块
const fs = require('fs/promises');
const path = require('path');

const allfiles = [
  'C:\\Users\\public',
  'C:\\Users\\public\\images',
  'C:\\Users\\public\\javascripts\\index1.js',
  'C:\\Users\\public\\javascripts\\index2.js'
]

/**
 * 检查单个路径是否为文件、且内容包含目标关键字
 * @param {string} targetPath 待检查的文件路径
 * @param {string} keyword 待匹配的关键字
 * @returns {string|null} 匹配成功返回完整路径，否则返回null
 */
const checkPathMatch = async (targetPath, keyword = 'sample') => {
  // 获取路径状态，判断是否为普通文件
  const stat = await fs.stat(targetPath);
  if (!stat.isFile()) return null;
  // 读取文件文本内容
  const content = await fs.readFile(targetPath, 'utf8');
  return content.includes(keyword) ? targetPath : null;
}

const run = async () => {
  const matchedPathList = [];
  // 使用for...of循环替代forEach，保证await阻塞流程正常执行
  for (const targetPath of allfiles) {
    const matchResult = await checkPathMatch(targetPath);
    if (matchResult) matchedPathList.push(matchResult);
  }
  console.log(matchedPathList);
}

run();

运行输出 #

当index1.js、index2.js文件内容包含sample关键字时，控制台将输出预期的匹配路径数组：

[
  'C:\\Users\\public\\javascripts\\index1.js',
  'C:\\Users\\public\\javascripts\\index2.js'
]

注意：如果需要提升批量处理的性能，可以将路径遍历逻辑改为并发执行，使用Promise.all替换for循环即可，目录类路径提前过滤即可。

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