Node.js 如何列出一个目录下的所有文件？

Node.js 列目录用 fs.readdir：回调版、Promise 版（fs.promises.readdir）、同步版（readdirSync）任选。加 withFileTypes 可区分文件与目录，递归遍历需自行实现或用第三方库。本文给出完整写法。

观测云编辑部 2026-09-28 3 分钟阅读更新于 2026-09-28

最佳实践

**用 fs.readdir 系列方法。**三种风格任选：

回调版

const fs = require('fs');

fs.readdir('/path/to/dir', (err, files) => {
  if (err) {
    console.error('读取目录失败:', err);
    return;
  }
  files.forEach(file => console.log(file));
});

Promise 版（推荐）

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

const files = await fs.readdir('/path/to/dir');
console.log(files);   // ['a.txt', 'subdir', 'b.js', ...]

同步版（脚本场景）

const fs = require('fs');
const files = fs.readdirSync('/path/to/dir');

区分文件和目录

readdir 只返回名字。加 withFileTypes: true 拿到类型信息：

const entries = await fs.readdir('/path/to/dir', { withFileTypes: true });
for (const e of entries) {
  if (e.isFile()) console.log('文件:', e.name);
  if (e.isDirectory()) console.log('目录:', e.name);
}

只想要文件（含过滤扩展名）

const files = (await fs.readdir(dir, { withFileTypes: true }))
  .filter(e => e.isFile() && e.name.endsWith('.js'))
  .map(e => e.name);

递归遍历子目录

readdir 不递归。简单递归实现：

const path = require('path');

async function walk(dir) {
  const entries = await fs.readdir(dir, { withFileTypes: true });
  const files = [];
  for (const e of entries) {
    const full = path.join(dir, e.name);
    if (e.isDirectory()) files.push(...await walk(full));
    else files.push(full);
  }
  return files;
}