Node.js 如何读取目录下所有文件？

Question

仓乃文 · Accepted Answer

Node.js 读取目录使用 fs.readdirSync（同步）或 fs.readdir（异步），配合 path 模块可以递归遍历所有子目录。

同步读取目录（简单场景）：
```javascript
const fs = require("fs");
const path = require("path");

const files = fs.readdirSync("./src");  // 读取目录下所有文件名
console.log(files);  // ["index.js", "utils.js", "components"]
```

递归遍历所有文件（推荐）：
```javascript
function getAllFiles(dirPath, arrayOfFiles = []) {
  const files = fs.readdirSync(dirPath);

files.forEach(file => {
    const fullPath = path.join(dirPath, file);
    if (fs.statSync(fullPath).isDirectory()) {
      arrayOfFiles = getAllFiles(fullPath, arrayOfFiles);  // 递归子目录
    } else {
      arrayOfFiles.push(fullPath);  // 收集文件路径
    }
  });

return arrayOfFiles;
}

const allFiles = getAllFiles("./src");
// ["./src/index.js", "./src/utils/helper.js", ...]
```

异步版本（适合大目录）：
```javascript
const fs = require("fs/promises");
const path = require("path");

async function getAllFiles(dirPath) {
  const entries = await fs.readdir(dirPath, { withFileTypes: true });
  const files = await Promise.all(entries.map(entry => {
    const fullPath = path.join(dirPath, entry.name);
    return entry.isDirectory() ? getAllFiles(fullPath) : fullPath;
  }));
  return files.flat();
}
```

补充说明：
- readdirSync 适合小目录和脚本，readdir 异步版适合服务端
- withFileTypes: true 可以避免额外 stat 调用，性能更好
- 递归遍历注意循环符号链接，可用 realpath 检测
- glob 库（如 fast-glob）提供了更强大的模式匹配功能