如何在2025年用JavaScript高效读取文件夹内所有文件在Node.js环境下，通过fs模块的promises API配合递归算法可以跨平台获取文件夹完整文件列表。核心方案是使用fs.readdir的withFileTypes选项区

如何在2025年用JavaScript高效读取文件夹内所有文件

在Node.js环境下，通过fs模块的promises API配合递归算法可以跨平台获取文件夹完整文件列表。核心方案是使用fs.readdir的withFileTypes选项区分文件/子目录，通过路径拼接实现深度遍历，2025年新增的File System Access API则让浏览器端有限实现了本地文件操作。

Node.js标准方案实现步骤

基础实现需要三要素：异步文件系统接口、类型判断逻辑和路径处理方法。最新Node.js版本推荐使用fs.promises替代回调式API，配合async/await可大幅提升代码可读性。

递归遍历核心代码

``` const { readdir, stat } = require('fs/promises'); const { join } = require('path'); async function scanDir(path) { const items = await readdir(path, { withFileTypes: true }); let files = []; await Promise.all(items.map(async item => { const fullPath = join(path, item.name); if(item.isDirectory()) { files = files.concat(await scanDir(fullPath)); } else { files.push(fullPath); } })); return files; } ``` 这段代码利用文件句柄的isDirectory方法进行类型判断，通过路径拼接保持绝对路径准确性，递归过程使用Promise.all实现并行处理提升性能。

浏览器环境创新方案

Chrome 103+支持的File System Access API允许通过showDirectoryPicker()方法获取目录句柄，配合新的getAsFileSystemHandle()方法可实现基于Promise的现代文件操作，但需要用户主动授权且仅限https环境使用。

性能优化关键点

大规模文件遍历时需注意：1) 设置最大递归深度避免栈溢出 2) 使用工作队列替代递归 3) 缓存文件状态减少IO操作 4) 采用流式处理超大型目录。Deno运行时在此场景下相比Node.js有约15%的性能提升。

Q&A常见问题

如何解决ENFILE系统文件打开数限制

Linux系统下可通过ulimit -n调整最大文件描述符数量，程序层面应控制并发读取数量，推荐使用p-queue等队列库实现可控并行度。

Web应用如何实现安全的客户端文件遍历

采用新的Origin Private File System标准，配合Service Worker缓存机制，可在沙盒环境中建立私有文件系统空间，最新Safari 19已全面支持该特性。

是否存在免递归的替代方案

可使用glob模式匹配库如fast-glob，其内部采用队列管理实现非递归遍历，在30000+文件量级时速度比传统递归快3-7倍。