如何使用Node.js遍历文件夹详解

在使用Node.js处理文件或文件夹时，我们有时需要遍历文件夹中的所有文件和子文件夹以查找特定的文件或执行某些操作。这里将提供一些基本的例子来演示如何使用Node.js遍历文件夹。

实现方法

Node.js提供了一个内置的模块fs，可以用来读取和处理文件和文件夹。配合path模块使用可以准确地定位到文件路径。下面是使用Node.js遍历文件夹的基本步骤：

1. 引入fs和path模块

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

1. 创建一个函数，并传入待遍历的文件夹路径作为参数

function traverseFolder(folderPath) {
  // ...
}

1. 使用fs模块读取当前文件夹中的所有文件和子文件夹列表，使用forEach或for循环遍历列表，执行特定操作或进入子文件夹遍历

function traverseFolder(folderPath) {
  // 读取文件夹列表
  const files = fs.readdirSync(folderPath)

  // 遍历文件夹列表
  files.forEach(function (fileName) {
    // 拼接当前文件路径
    const filePath = path.join(folderPath, fileName)

    // 判断该路径是文件夹还是文件
    const stats = fs.statSync(filePath)

    if (stats.isDirectory()) {
      // 如果是文件夹，递归遍历
      traverseFolder(filePath)
    } else {
      // 如果是文件，执行操作
      console.log(filePath)
    }
  })
}

示例一

现在假设我们要在指定文件夹（假设是/Users/username/Documents）中查找并返回所有以.txt结尾的文件路径。

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

function findTextFiles(folderPath) {
  const result = []

  function traverseFolder(folderPath) {
    const files = fs.readdirSync(folderPath)

    files.forEach(function (fileName) {
      const filePath = path.join(folderPath, fileName)
      const stats = fs.statSync(filePath)

      if (stats.isDirectory()) {
        traverseFolder(filePath)
      } else {
        if (path.extname(fileName) === '.txt') {
          result.push(filePath)
        }
      }
    })
  }

  traverseFolder(folderPath)

  return result
}

这里定义了一个叫findTextFiles的函数，接收一个文件夹路径作为参数，并返回所有以.txt结尾的文件路径。函数内部使用了另一个叫traverseFolder的函数遍历文件夹，并将符合条件的文件路径添加到一个数组中。

示例二

现在我们还想在指定文件夹（假设是/Users/username/Documents）中查找第一个出现的.txt文件路径。

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

function findFirstTextFile(folderPath) {
  let result = null

  function traverseFolder(folderPath) {
    const files = fs.readdirSync(folderPath)

    files.forEach(function (fileName) {
      const filePath = path.join(folderPath, fileName)
      const stats = fs.statSync(filePath)

      if (stats.isDirectory()) {
        traverseFolder(filePath)
      } else {
        if (path.extname(fileName) === '.txt' && !result) {
          result = filePath
        }
      }
    })
  }

  traverseFolder(folderPath)

  return result
}

这里定义了一个叫findFirstTextFile的函数，接收一个文件夹路径作为参数，并返回第一个出现的以.txt结尾的文件路径。函数内部同样使用了traverseFolder函数遍历文件夹，并在找到符合条件的文件后立即返回结果。

总结

遍历文件夹是Node.js文件操作中的常见需求，掌握这个技能可以方便实现很多复杂的文件操作。上面提供的方法只是遍历文件夹的基础，使用起来可以根据实际需求进行定制。