如何获取Node.js目录中所有文件的名称列表?


979

我正在尝试使用Node.js获取目录中存在的所有文件的名称的列表。我想要的输出是一个文件名数组。我怎样才能做到这一点?


9
fs.readdir可以,但是不能使用文件名的glob模式(例如)ls /tmp/*core*。查看github.com/isaacs/node-glob。Glob甚至可以在子目录中搜索。
Jess

readdir-recursive如果您也在寻找子目录中的文件名,也可以签出NPM的模块
Ethan Davis


1
fs.readdir是一个简单的异步解决方案- 此处的
drorw

仍然不使用迭代器回答吗?我要扫描250万个文件……我不想在10分钟后得到2.5m的路径列表。
Flavien Volken '19

Answers:


1342

您可以使用fs.readdirfs.readdirSync方法。

fs.readdir

const testFolder = './tests/';
const fs = require('fs');

fs.readdir(testFolder, (err, files) => {
  files.forEach(file => {
    console.log(file);
  });
});

fs.readdirSync

const testFolder = './tests/';
const fs = require('fs');

fs.readdirSync(testFolder).forEach(file => {
  console.log(file);
});

两种方法的区别在于,第一种是异步的,因此您必须提供一个回调函数,该函数将在读取过程结束时执行。

第二个是同步的,它将返回文件名数组,但它将停止代码的任何进一步执行,直到读取过程结束。


204
注意:readdir还显示目录名称。要过滤这些,请使用fs.stat(path, callback(err, stats))stats.isDirectory()
罗布W

3
我应该补充一点,因为您不想阻塞节点中的IO,所以您很可能应该使用readdire。
DragonKnight

5
@ user3705055,除非您正在使用gulp读取源顺序相关文件的目录并将其编译为单个可执行文件。
r3wt


2
@Sancarn您想尝试解析输出ls吗?只是等到有人创建带有嵌入式空格和换行符的文件名……
Radon Rosborough,

199

IMO执行此类任务的最便捷方法是使用全局工具。这是用于node.js 的glob包。与安装

npm install glob

然后使用通配符匹配文件名(示例取自软件包的网站)

var glob = require("glob")

// options is optional
glob("**/*.js", options, function (er, files) {
  // files is an array of filenames.
  // If the `nonull` option is set, and nothing
  // was found, then files is ["**/*.js"]
  // er is an error object or null.
})

5
这对我来说是最好的解决方案,因为我想指定文件类型比字符串比较容易。谢谢。
Pogrindis 2014年

我也很喜欢这一点,因为在节点中,遍历几乎是一项基本技能。如果您只想找回文件名,请cwd在options对象中传递a 。
jcollum 2015年

1
如何获得glob外部结果呢?例如。我要console.log结果,但不里面glob()
兰提

13
@Lanti:该glob.sync(pattern, [options])方法可能更易于使用,因为它仅返回文件名数组,而不是使用回调。此处的更多信息:github.com/isaacs/node-glob
Glenn Lawrence

1
对于像我这样寻找使用Promises的全局实现的人,请查看sindresorhus的globby:github.com/sindresorhus/globby
Nacho Coloma,

180

上面的答案虽然不会对目录执行递归搜索。下面是我做了一个递归搜索(使用节点行走npm install walk

var walk    = require('walk');
var files   = [];

// Walker options
var walker  = walk.walk('./test', { followLinks: false });

walker.on('file', function(root, stat, next) {
    // Add this file to the list of files
    files.push(root + '/' + stat.name);
    next();
});

walker.on('end', function() {
    console.log(files);
});

4
fs.readdirSync更好,为此专门创建了本机替代方案。
伊拉登(Eraden)2012年

37
不幸的是,fs.readdirSync不会进入子目录,除非您愿意编写自己的例程来执行此操作,否则您不会想到已经有npm模块来解决此问题。
鲁本·谭

6
这是步行github repo + docs的链接:github.com/coolaj86/node-walk
santiagoIT

OP没有询问哪个API进行递归读取。无论如何,接受的答案提供了什么,也可以作为进行递归阅读的基础。
伊格威·卡卢

这是一个了不起的功能。快速提问:有没有一种快速方法来忽略某些目录?我想忽略以.git
j_d为

91

获取所有子目录中的文件

function getFiles (dir, files_){
    files_ = files_ || [];
    var files = fs.readdirSync(dir);
    for (var i in files){
        var name = dir + '/' + files[i];
        if (fs.statSync(name).isDirectory()){
            getFiles(name, files_);
        } else {
            files_.push(name);
        }
    }
    return files_;
}

console.log(getFiles('path/to/dir'))

4
为什么if (typeof files_ === 'undefined') files_=[];呢 您只需要var files_ = files_ || [];代替即可files_ = files_ || [];
jkutianski 2014年

4
您忘了var fs = require('fs');在的开头添加getFiles
GFoley83

这是一种递归方法。它不支持非常深的文件夹结构,这将导致堆栈溢出。
Mathias Lykkegaard Lorenzen

63

这是仅使用本机fspath模块的简单解决方案:

// sync version
function walkSync(currentDirPath, callback) {
    var fs = require('fs'),
        path = require('path');
    fs.readdirSync(currentDirPath).forEach(function (name) {
        var filePath = path.join(currentDirPath, name);
        var stat = fs.statSync(filePath);
        if (stat.isFile()) {
            callback(filePath, stat);
        } else if (stat.isDirectory()) {
            walkSync(filePath, callback);
        }
    });
}

或异步版本(fs.readdir改为使用):

// async version with basic error handling
function walk(currentDirPath, callback) {
    var fs = require('fs'),
        path = require('path');
    fs.readdir(currentDirPath, function (err, files) {
        if (err) {
            throw new Error(err);
        }
        files.forEach(function (name) {
            var filePath = path.join(currentDirPath, name);
            var stat = fs.statSync(filePath);
            if (stat.isFile()) {
                callback(filePath, stat);
            } else if (stat.isDirectory()) {
                walk(filePath, callback);
            }
        });
    });
}

然后,您只需致电(用于同步版本):

walkSync('path/to/root/dir', function(filePath, stat) {
    // do something with "filePath"...
});

或异步版本:

walk('path/to/root/dir', function(filePath, stat) {
    // do something with "filePath"...
});

区别在于执行IO时节点如何阻塞。鉴于以上API相同,您可以仅使用异步版本来确保最佳性能。

但是,使用同步版本有一个优点。遍历完成后立即执行一些代码会更容易,就像遍历之后的下一条语句一样。使用异步版本,您将需要一些额外的方式来了解何时完成操作。也许先创建所有路径的地图,然后枚举它们。对于简单的构建/实用程序脚本(相对于高性能Web服务器),您可以使用同步版本而不会造成任何损坏。


1
应更换线walkSyncwalk(filePath, callback);walkSync(filePath, callback);
MIDE11

3
但是您仍在使用异步版本的fs.statSync,它会阻止。您不应该使用fs.stat吗?
MindlessRanger

这确实很有帮助,并且此方法是递归的。谢谢!
Little Roys

35

从Node v10.10.0开始,可以将new withFileTypes选项用于此功能,fs.readdirfs.readdirSync与该dirent.isDirectory()功能结合使用以过滤目录中的文件名。看起来像这样:

fs.readdirSync('./dirpath', {withFileTypes: true})
.filter(item => !item.isDirectory())
.map(item => item.name)

返回的数组的形式为:

['file1.txt', 'file2.txt', 'file3.txt']

fs.Dirent类的文档


7
到目前为止,这是最好的答案!
Alex Ivasyuv '19年

2
这是人们在2020年寻找的-应该“固定”
Val Redchenko

1
最佳答案2020年!
伊夫·兰格

26

在ES7中使用Promises

与mz / fs异步使用

mz模块提供核心节点库的承诺版本。使用它们很简单。首先安装库...

npm install mz

然后...

const fs = require('mz/fs');
fs.readdir('./myDir').then(listing => console.log(listing))
  .catch(err => console.error(err));

或者,您可以在ES7的异步函数中编写它们:

async function myReaddir () {
  try {
    const file = await fs.readdir('./myDir/');
  }
  catch (err) { console.error( err ) }
};

更新递归列表

一些用户已经指定希望查看递归列表(尽管不在问题中)...使用fs-promise。这是一个薄薄的包装纸mz

npm install fs-promise;

然后...

const fs = require('fs-promise');
fs.walk('./myDir').then(
    listing => listing.forEach(file => console.log(file.path))
).catch(err => console.error(err));

5
fs.walk从因为它不它由FS支持FS-承诺移除(github.com/kevinbeaty/fs-promise/issues/28
阿德南

20

依赖关系。

var fs = require('fs');
var path = require('path');

定义。

// String -> [String]
function fileList(dir) {
  return fs.readdirSync(dir).reduce(function(list, file) {
    var name = path.join(dir, file);
    var isDir = fs.statSync(name).isDirectory();
    return list.concat(isDir ? fileList(name) : [name]);
  }, []);
}

用法。

var DIR = '/usr/local/bin';

// 1. List all files in DIR
fileList(DIR);
// => ['/usr/local/bin/babel', '/usr/local/bin/bower', ...]

// 2. List all file names in DIR
fileList(DIR).map((file) => file.split(path.sep).slice(-1)[0]);
// => ['babel', 'bower', ...]

请注意,这fileList太乐观了。对于任何严重的问题,请添加一些错误处理。


1
我还添加了一个excludeDirs数组参数。它对其进行了足够的更改,因此也许您应该对其进行编辑(如果需要)。否则,我将其添加到其他答案中。gist.github.com/AlecTaylor/f3f221b4fb86b4375650
AT

1
@AT好!您应该发布自己的答案,因为这是一个有用的扩展。让我们保持这一功能不变。
湖南罗斯托

19

非递归版本

您并不是说要递归地进行操作,因此我假设您只需要目录的直接子级即可。

样例代码:

const fs = require('fs');
const path = require('path');

fs.readdirSync('your-directory-path')
  .filter((file) => fs.lstatSync(path.join(folder, file)).isFile());

10

负载fs

const fs = require('fs');

异步读取文件:

fs.readdir('./dir', function (err, files) {
    // "files" is an Array with files names
});

读取文件同步

var files = fs.readdirSync('./dir');

10

如果有人仍然在搜索这个,我这样做:

import fs from 'fs';
import path from 'path';

const getAllFiles = dir =>
    fs.readdirSync(dir).reduce((files, file) => {
        const name = path.join(dir, file);
        const isDirectory = fs.statSync(name).isDirectory();
        return isDirectory ? [...files, ...getAllFiles(name)] : [...files, name];
    }, []);

对我来说很好


对我来说很棒,而且它是递归的。只要记住,导入语法仍然在Node中的标志后面,您可能必须采用旧方法:const fs = require('fs');
mjsarfatti

@Josh就像魅力一样工作。但是,在了解[...files, ...getAllFiles(name)][...files, name]工作原理方面有些困难。一点解释将非常有帮助:)
Mazedul Islam Khan女士

1
@MdMazedulIslamKhan这里...使用的称为传播语法。它的基本作用是将数组中的所有对象都“散布”到新数组中。在这种情况下,将files数组内的所有条目与从递归调用返回的所有值一起添加到返回中。:你可以参考蔓延语法这里developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/...
T90

8

获取sorted文件名。您可以基于特定的过滤结果,extension例如'.txt''.jpg'等等。

import * as fs from 'fs';
import * as Path from 'path';

function getFilenames(path, extension) {
    return fs
        .readdirSync(path)
        .filter(
            item =>
                fs.statSync(Path.join(path, item)).isFile() &&
                (extension === undefined || Path.extname(item) === extension)
        )
        .sort();
}

6

从您的问题中我假设您不需要目录名称,而只需要文件。

例:

animals
├── all.jpg
├── mammals
   └── cat.jpg
   └── dog.jpg
└── insects
    └── bee.jpg

如果只需要一个文件路径数组,请使用return_object: false

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

async function walk(dir) {
    let files = await fs.readdir(dir);
    files = await Promise.all(files.map(async file => {
        const filePath = path.join(dir, file);
        const stats = await fs.stat(filePath);
        if (stats.isDirectory()) return walk(filePath);
        else if(stats.isFile()) return filePath;
    }));

    return files.reduce((all, folderContents) => all.concat(folderContents), []);
}

console.log(walk('animals'))

返回:

[
  "/animals/all.jpg",
  "/animals/mammals/cat.jpg",
  "/animals/mammals/dog.jpg",
  "/animals/insects/bee.jpg"
];

积分请访问https://gist.github.com/lovasoa/8691344#gistcomment-2927279


5

这是异步递归版本。

    function ( path, callback){
     // the callback gets ( err, files) where files is an array of file names
     if( typeof callback !== 'function' ) return
     var
      result = []
      , files = [ path.replace( /\/\s*$/, '' ) ]
     function traverseFiles (){
      if( files.length ) {
       var name = files.shift()
       fs.stat(name, function( err, stats){
        if( err ){
         if( err.errno == 34 ) traverseFiles()
    // in case there's broken symbolic links or a bad path
    // skip file instead of sending error
         else callback(err)
        }
        else if ( stats.isDirectory() ) fs.readdir( name, function( err, files2 ){
         if( err ) callback(err)
         else {
          files = files2
           .map( function( file ){ return name + '/' + file } )
           .concat( files )
          traverseFiles()
         }
        })
        else{
         result.push(name)
         traverseFiles()
        }
       })
      }
      else callback( null, result )
     }
     traverseFiles()
    }

4
养成在语句末尾添加分号的习惯。否则,您无法缩小代码。不过,感谢您急需的异步贡献。
user2867288

2
哈哈哈哈,这不是规范的一部分,只是一些随机的人称其首选的棉绒风格为“ standardjs”。分号是很好的做法,尤其是在Javascript中,以保持代码的清晰度。否则,您和您的团队必须记住自动分号插入的规则,而且我至少知道我所从事的普通JS开发人员并不那么勤奋。
user2867288 '19

@ user2867288但是由于ASI存在,我们可以使用它,不是吗?我使用eslint和pettertier定期保存代码格式,而分号插入不是问题。
杜伊拉

5

采用了@ Hunan-Rostomyan的通用方法,使它变得更加简洁,并增加了excludeDirs论点。用扩展很简单includeDirs,只需遵循相同的模式:

import * as fs from 'fs';
import * as path from 'path';

function fileList(dir, excludeDirs?) {
    return fs.readdirSync(dir).reduce(function (list, file) {
        const name = path.join(dir, file);
        if (fs.statSync(name).isDirectory()) {
            if (excludeDirs && excludeDirs.length) {
                excludeDirs = excludeDirs.map(d => path.normalize(d));
                const idx = name.indexOf(path.sep);
                const directory = name.slice(0, idx === -1 ? name.length : idx);
                if (excludeDirs.indexOf(directory) !== -1)
                    return list;
            }
            return list.concat(fileList(name, excludeDirs));
        }
        return list.concat([name]);
    }, []);
}

用法示例:

console.log(fileList('.', ['node_modules', 'typings', 'bower_components']));

我有一个主文件夹:scss,在其中另一个文件夹:themes,但最终列表为我提供了所有目录,不仅有不包含目录的目录,还会发生什么?
SalahAdDin 2016年

仅适用于'。' 文件夹目录,其余目录不起作用。
SalahAdDin

5

盒子外面

如果您想使用现成的目录结构对象,我强烈建议您检查目录树

假设您具有以下结构:

photos
   june
   └── windsurf.jpg
└── january
    ├── ski.png
    └── snowboard.jpg
const dirTree = require("directory-tree");
const tree = dirTree("/path/to/photos");

将返回:

{
  path: "photos",
  name: "photos",
  size: 600,
  type: "directory",
  children: [
    {
      path: "photos/june",
      name: "june",
      size: 400,
      type: "directory",
      children: [
        {
          path: "photos/june/windsurf.jpg",
          name: "windsurf.jpg",
          size: 400,
          type: "file",
          extension: ".jpg"
        }
      ]
    },
    {
      path: "photos/january",
      name: "january",
      size: 200,
      type: "directory",
      children: [
        {
          path: "photos/january/ski.png",
          name: "ski.png",
          size: 100,
          type: "file",
          extension: ".png"
        },
        {
          path: "photos/january/snowboard.jpg",
          name: "snowboard.jpg",
          size: 100,
          type: "file",
          extension: ".jpg"
        }
      ]
    }
  ]
}

自订物件

否则,如果要使用自定义设置创建目录树对象,请查看以下代码片段。在此codeandbox上有一个实时示例。

// my-script.js
const fs = require("fs");
const path = require("path");

const isDirectory = filePath => fs.statSync(filePath).isDirectory();
const isFile = filePath => fs.statSync(filePath).isFile();

const getDirectoryDetails = filePath => {
  const dirs = fs.readdirSync(filePath);
  return {
    dirs: dirs.filter(name => isDirectory(path.join(filePath, name))),
    files: dirs.filter(name => isFile(path.join(filePath, name)))
  };
};

const getFilesRecursively = (parentPath, currentFolder) => {
  const currentFolderPath = path.join(parentPath, currentFolder);
  let currentDirectoryDetails = getDirectoryDetails(currentFolderPath);

  const final = {
    current_dir: currentFolder,
    dirs: currentDirectoryDetails.dirs.map(dir =>
      getFilesRecursively(currentFolderPath, dir)
    ),
    files: currentDirectoryDetails.files
  };

  return final;
};

const getAllFiles = relativePath => {
  const fullPath = path.join(__dirname, relativePath);
  const parentDirectoryPath = path.dirname(fullPath);
  const leafDirectory = path.basename(fullPath);

  const allFiles = getFilesRecursively(parentDirectoryPath, leafDirectory);
  return allFiles;
};

module.exports = { getAllFiles };

然后,您可以简单地执行以下操作:

// another-file.js 

const { getAllFiles } = require("path/to/my-script");

const allFiles = getAllFiles("/path/to/my-directory");

3

这是一个TypeScript,可选的递归,可选的错误记录和异步解决方案。您可以为要查找的文件名指定一个正则表达式。

fs-extra之所以使用它,是因为它是对的简单超级设置改进fs

import * as FsExtra from 'fs-extra'

/**
 * Finds files in the folder that match filePattern, optionally passing back errors .
 * If folderDepth isn't specified, only the first level is searched. Otherwise anything up
 * to Infinity is supported.
 *
 * @static
 * @param {string} folder The folder to start in.
 * @param {string} [filePattern='.*'] A regular expression of the files you want to find.
 * @param {(Error[] | undefined)} [errors=undefined]
 * @param {number} [folderDepth=0]
 * @returns {Promise<string[]>}
 * @memberof FileHelper
 */
public static async findFiles(
    folder: string,
    filePattern: string = '.*',
    errors: Error[] | undefined = undefined,
    folderDepth: number = 0
): Promise<string[]> {
    const results: string[] = []

    // Get all files from the folder
    let items = await FsExtra.readdir(folder).catch(error => {
        if (errors) {
            errors.push(error) // Save errors if we wish (e.g. folder perms issues)
        }

        return results
    })

    // Go through to the required depth and no further
    folderDepth = folderDepth - 1

    // Loop through the results, possibly recurse
    for (const item of items) {
        try {
            const fullPath = Path.join(folder, item)

            if (
                FsExtra.statSync(fullPath).isDirectory() &&
                folderDepth > -1)
            ) {
                // Its a folder, recursively get the child folders' files
                results.push(
                    ...(await FileHelper.findFiles(fullPath, filePattern, errors, folderDepth))
                )
            } else {
                // Filter by the file name pattern, if there is one
                if (filePattern === '.*' || item.search(new RegExp(filePattern, 'i')) > -1) {
                    results.push(fullPath)
                }
            }
        } catch (error) {
            if (errors) {
                errors.push(error) // Save errors if we wish
            }
        }
    }

    return results
}

1

这将起作用并将结果存储在test.txt文件中,该文件将出现在同一目录中

  fs.readdirSync(__dirname).forEach(file => {
    fs.appendFileSync("test.txt", file+"\n", function(err){
    })
})

1

我最近为此构建了一个工具,可以执行此操作...它异步获取目录并返回项目列表。您可以获取目录,文件或同时获取目录和文件,首先要获取文件夹。如果您不想获取整个文件夹,也可以对数据进行分页。

https://www.npmjs.com/package/fs-browser

这是链接,希望对您有所帮助!



0

我制作了一个节点模块来自动执行此任务:mddir

用法

节点mddir“ ../relative/path/”

要安装:npm install mddir -g

生成当前目录的markdown:mddir

生成任何绝对路径:mddir / absolute / path

生成相对路径:mddir〜/ Documents / whatever。

md文件在您的工作目录中生成。

当前忽略node_modules和.git文件夹。

故障排除

如果收到错误“ node \ r:没有这样的文件或目录”,则问题是您的操作系统使用不同的行尾,并且如果您未将行尾样式显式设置为Unix,则mddir无法解析它们。这通常会影响Windows,但也会影响Linux的某些版本。必须在mddir npm全局bin文件夹中将行尾设置为Unix样式。

行尾修复

使用以下命令获取npm bin文件夹路径:

npm config get prefix

将CD放入该文件夹

brew安装dos2unix

dos2unix lib / node_modules / mddir / src / mddir.js

这会将行尾转换为Unix而不是Dos

然后使用以下命令正常运行:node mddir“ ../relative/path/”。

示例生成的降价文件结构“ directoryList.md”

    |-- .bowerrc
    |-- .jshintrc
    |-- .jshintrc2
    |-- Gruntfile.js
    |-- README.md
    |-- bower.json
    |-- karma.conf.js
    |-- package.json
    |-- app
        |-- app.js
        |-- db.js
        |-- directoryList.md
        |-- index.html
        |-- mddir.js
        |-- routing.js
        |-- server.js
        |-- _api
            |-- api.groups.js
            |-- api.posts.js
            |-- api.users.js
            |-- api.widgets.js
        |-- _components
            |-- directives
                |-- directives.module.js
                |-- vendor
                    |-- directive.draganddrop.js
            |-- helpers
                |-- helpers.module.js
                |-- proprietary
                    |-- factory.actionDispatcher.js
            |-- services
                |-- services.cardTemplates.js
                |-- services.cards.js
                |-- services.groups.js
                |-- services.posts.js
                |-- services.users.js
                |-- services.widgets.js
        |-- _mocks
            |-- mocks.groups.js
            |-- mocks.posts.js
            |-- mocks.users.js
            |-- mocks.widgets.js

0

使用npm 列表内容模块。它读取给定目录的内容和子内容,并返回文件和文件夹路径的列表。

const list = require('list-contents');

list("./dist",(o)=>{
  if(o.error) throw o.error;
   console.log('Folders: ', o.dirs);
   console.log('Files: ', o.files);
});

-1
function getFilesRecursiveSync(dir, fileList, optionalFilterFunction) {
    if (!fileList) {
        grunt.log.error("Variable 'fileList' is undefined or NULL.");
        return;
    }
    var files = fs.readdirSync(dir);
    for (var i in files) {
        if (!files.hasOwnProperty(i)) continue;
        var name = dir + '/' + files[i];
        if (fs.statSync(name).isDirectory()) {
            getFilesRecursiveSync(name, fileList, optionalFilterFunction);
        } else {
            if (optionalFilterFunction && optionalFilterFunction(name) !== true)
                continue;
            fileList.push(name);
        }
    }
}
By using our site, you acknowledge that you have read and understand our Cookie Policy and Privacy Policy.
Licensed under cc by-sa 3.0 with attribution required.