怎样使用Node.js操作子目录？-js教程-PHP中文网

Node.js操作子目录需掌握fs模块的异步API，核心方法包括使用fs.promises配合async/await实现目录的创建（mkdir，recursive: true）、读取（readdir）、删除（rm，recursive: true和force: true）及重命名（rename），路径处理应避免相对路径陷阱，优先使用__dirname和path.join确保正确性，递归遍历可通过判断dirent类型实现深度遍历，删除非空目录推荐现代API fs.rm()以简化操作并增强健壮性。

怎样使用node.js操作子目录？

Node.js操作子目录，核心在于灵活运用内置的

fs

登录后复制

模块提供的异步API，尤其是涉及到目录的创建、读取、删除和重命名。关键在于理解路径处理的细微之处，以及如何有效地处理异步操作和潜在的错误。说实话，这块一开始确实有点绕，但掌握了几个核心方法，就会觉得Node.js在文件系统操作上是相当强大的。

解决方案

要使用Node.js操作子目录，我们主要依赖

fs

登录后复制

模块。我个人更倾向于使用

fs.promises

登录后复制

API，因为它与

async/await

登录后复制

结合起来，代码可读性会好很多，避免了回调地狱。

1. 创建子目录： 如果你需要创建一个多层级的子目录（比如

./a/b/c

登录后复制

），最方便的方式是使用

recursive: true

登录后复制

选项。

import { mkdir } from 'node:fs/promises';
import { join } from 'node:path';

async function createSubdirectory(basePath, subDirName) {
  const fullPath = join(basePath, subDirName);
  try {
    await mkdir(fullPath, { recursive: true });
    console.log(`目录 '${fullPath}' 已创建。`);
  } catch (err) {
    if (err.code === 'EEXIST') {
      console.log(`目录 '${fullPath}' 已经存在。`);
    } else {
      console.error(`创建目录时出错: ${err.message}`);
    }
  }
}

// 示例：在当前目录下创建 'data/logs/2023'
createSubdirectory(process.cwd(), 'data/logs/2023');

登录后复制

2. 读取子目录内容： 获取一个目录下的所有文件和子目录名。

import { readdir, stat } from 'node:fs/promises';
import { join } from 'node:path';

async function listDirectoryContents(dirPath) {
  try {
    const entries = await readdir(dirPath, { withFileTypes: true }); // withFileTypes 很有用，可以直接判断类型
    console.log(`目录 '${dirPath}' 的内容:`);
    for (const entry of entries) {
      if (entry.isDirectory()) {
        console.log(`  [目录] ${entry.name}`);
      } else if (entry.isFile()) {
        console.log(`  [文件] ${entry.name}`);
      } else {
        console.log(`  [其他] ${entry.name}`);
      }
    }
  } catch (err) {
    console.error(`读取目录时出错: ${err.message}`);
  }
}

// 示例：列出当前目录下的内容
listDirectoryContents(process.cwd());

登录后复制

3. 删除子目录： 删除非空子目录，务必使用

recursive: true

登录后复制

和

force: true

登录后复制

。否则，如果目录非空，操作会失败。

import { rm } from 'node:fs/promises';
import { join } from 'node:path';

async function removeSubdirectory(basePath, subDirName) {
  const fullPath = join(basePath, subDirName);
  try {
    await rm(fullPath, { recursive: true, force: true });
    console.log(`目录 '${fullPath}' 及其内容已删除。`);
  } catch (err) {
    console.error(`删除目录时出错: ${err.message}`);
  }
}

// 示例：删除之前创建的 'data' 目录
// 注意：这会删除 'data' 及其所有子内容，请谨慎操作！
removeSubdirectory(process.cwd(), 'data');

登录后复制

4. 重命名或移动子目录：

fs.rename

登录后复制

可以用来重命名一个目录，也可以用来将一个目录移动到另一个位置。

import { rename } from 'node:fs/promises';
import { join } from 'node:path';

async function renameOrMoveSubdirectory(oldPath, newPath) {
  try {
    await rename(oldPath, newPath);
    console.log(`目录已从 '${oldPath}' 移动/重命名到 '${newPath}'。`);
  } catch (err) {
    console.error(`重命名/移动目录时出错: ${err.message}`);
  }
}

// 示例：将 'old_dir' 重命名为 'new_dir'
// 先创建 'old_dir' 才能测试
// await createSubdirectory(process.cwd(), 'old_dir');
// renameOrMoveSubdirectory(join(process.cwd(), 'old_dir'), join(process.cwd(), 'new_dir'));

// 示例：将 'source_dir' 移动到 'destination/target_dir'
// await createSubdirectory(process.cwd(), 'source_dir');
// await createSubdirectory(process.cwd(), 'destination');
// renameOrMoveSubdirectory(join(process.cwd(), 'source_dir'), join(process.cwd(), 'destination', 'target_dir'));

登录后复制

在Node.js中如何递归地遍历子目录结构？

递归遍历子目录结构，这在处理文件上传、备份、内容索引等场景下非常常见。我的经验是，使用

async/await

登录后复制

和

fs.promises

登录后复制

能让递归逻辑清晰很多，避免了层层嵌套的回调。

基本思路是：

读取当前目录下的所有条目。
对于每个条目，判断它是文件还是目录。
如果是文件，就处理它（比如打印文件名，或者读取内容）。
如果是目录，就递归地调用自身，传入新的目录路径。

这里有一个实用的递归遍历函数示例：

import { readdir, stat } from 'node:fs/promises';
import { join } from 'node:path';

async function traverseDirectory(currentPath, indent = 0) {
  const prefix = '  '.repeat(indent); // 用于美化输出的缩进

  try {
    const entries = await readdir(currentPath, { withFileTypes: true });

    for (const entry of entries) {
      const entryPath = join(currentPath, entry.name);

      if (entry.isDirectory()) {
        console.log(`${prefix}[目录] ${entry.name}`);
        await traverseDirectory(entryPath, indent + 1); // 递归调用
      } else if (entry.isFile()) {
        console.log(`${prefix}[文件] ${entry.name}`);
      }
      // 也可以处理其他类型，比如符号链接等
    }
  } catch (err) {
    // 权限问题 (EACCES) 或路径不存在 (ENOENT) 是常见的错误
    console.error(`${prefix}遍历目录 '${currentPath}' 时出错: ${err.message}`);
  }
}

// 示例：从当前目录开始递归遍历
// 建议在一个测试目录中运行，避免遍历整个项目目录导致输出过多
// 例如，先创建一个测试结构：
// mkdir -p test_dir/sub1/sub1_1
// touch test_dir/file1.txt test_dir/sub1/file2.log
// await traverseDirectory(join(process.cwd(), 'test_dir'));
// traverseDirectory(process.cwd()); // 遍历当前项目目录

登录后复制

在实际项目中，我们可能需要对遍历的结果进行收集，而不是简单地打印。这可以通过传递一个数组或映射来收集文件路径、目录结构等信息。另外，对于非常大的文件系统，需要考虑异步操作的并发限制，避免同时打开过多文件句柄，这可以通过

p-limit

登录后复制

或

async.queue

登录后复制

等库来管理。

处理子目录时，Node.js中的路径问题有哪些常见陷阱？

路径问题，说实话，是我在Node.js文件系统操作中踩坑最多的地方，没有之一。它不像代码逻辑那么直观，往往是环境差异或者一些默认行为导致的问题。

1. 相对路径与绝对路径的混淆：

./
登录后复制
和
../
登录后复制
：这些是相对路径，它们是相对于
```
process.cwd()
```
登录后复制
（当前工作目录）解析的，而不是脚本文件所在的目录。如果你在项目的根目录执行一个位于
```
src/utils/
```
登录后复制
下的脚本，脚本中的
```
./data
```
登录后复制
会指向
```
./data
```
登录后复制
而不是
```
src/utils/data
```
登录后复制
。这很让人困惑。
__dirname
登录后复制
和
__filename
登录后复制
：这两个全局变量是救星！它们总是指向当前执行的脚本文件所在的目录和文件本身的绝对路径。所以，如果我想确保我的文件操作是相对于脚本文件本身的位置，我总是会用
```
path.join(__dirname, 'my_subdir')
```
登录后复制
。
path.resolve()
登录后复制
和
path.join()
登录后复制
：
- ```
path.join()
```
  登录后复制
  ：简单地将所有路径片段连接起来，并规范化（处理
```
..
```
  登录后复制
  和
```
.
```
  登录后复制
  ），但不解析为绝对路径。
- ```
path.resolve()
```
  登录后复制
  ：会从右到左处理路径片段，直到生成一个绝对路径。如果遇到以
```
/
```
  登录后复制
  开头的片段，它会认为是根目录。如果没有提供根路径，它会使用
```
process.cwd()
```
  登录后复制
  作为起点。我通常用它来确保得到一个干净的绝对路径。
- 示例：
```
  import { join, resolve } from 'node:path';
  console.log(join('/foo', 'bar', 'baz/asdf', 'quux', '..')); // /foo/bar/baz/asdf
  console.log(resolve('/foo/bar', './baz')); // /foo/bar/baz
  console.log(resolve('/foo/bar', '/tmp/file/')); // /tmp/file
  console.log(resolve('wwwroot', 'static_files/png/', '../gif/index.gif')); // C:\Users\...\wwwroot\static_files\gif\index.gif (Windows)
```
  登录后复制

2. 跨平台路径分隔符： Windows使用

登录后复制

，Unix-like系统（Linux, macOS）使用

登录后复制

。直接拼接字符串来构建路径是灾难性的。

path.join()

登录后复制

和

path.resolve()

登录后复制

会自动处理这些差异，使用

path.sep

登录后复制

可以获取当前系统的分隔符。所以，永远不要手动拼接路径字符串，用

path.join

登录后复制

！

3. 异步操作中的路径上下文： 在复杂的异步流程中，如果路径是动态生成的或者依赖于某个异步操作的结果，一定要确保路径在文件操作执行时是正确的、完整的。有时候一个变量名写错，或者一个异步回调的参数没传对，都会导致路径错误，而且这种错误往往很难排查。

4. 权限问题： 这不是严格意义上的路径问题，但经常伴随路径问题出现。如果你尝试在一个没有写入权限的目录创建文件，或者读取一个没有读取权限的目录，Node.js会抛出

EACCES

登录后复制

错误。确保你的Node.js进程有足够的权限执行文件操作。

如何安全有效地删除包含文件的非空子目录？

删除包含文件的非空子目录，这听起来简单，但如果操作不当，可能会导致数据丢失或程序崩溃。在Node.js中，这块的API经历了一些演变，现在已经非常方便了。

种子软件项目管理系统后台模板

种子软件项目管理系统后台模板，蓝色风格，整套后台模板，用的图片很少，运行占用资源少，包含登录页面和几十个静态后台操作页面，下载后只要做少部分改动即可使用。

336

查看详情

现代Node.js (v14.0.0+): 使用

fs.rm()

登录后复制

从Node.js 14开始，

fs.rm()

登录后复制

（或其Promise版本

fs.promises.rm()

登录后复制

）是删除文件和目录的推荐方法。它取代了

fs.unlink()

登录后复制

（删除文件）和

fs.rmdir()

登录后复制

（删除空目录）。

关键在于使用

recursive: true

登录后复制

和

force: true

登录后复制

选项：

import { rm } from 'node:fs/promises';
import { join } from 'node:path';

async function safelyRemoveDirectory(dirPath) {
  try {
    // recursive: true 允许删除非空目录及其所有内容
    // force: true 忽略路径不存在的错误，如果目录不存在，不会报错
    await rm(dirPath, { recursive: true, force: true });
    console.log(`目录 '${dirPath}' 及其所有内容已安全删除。`);
  } catch (err) {
    // 仍然需要捕获其他可能的错误，例如权限问题
    console.error(`删除目录 '${dirPath}' 时出错: ${err.message}`);
  }
}

// 示例：
// 假设有一个名为 'temp_data' 的目录，里面有文件和子目录
// await safelyRemoveDirectory(join(process.cwd(), 'temp_data'));

登录后复制

为什么

recursive: true

登录后复制

和
force: true
登录后复制
很重要？

recursive: true
登录后复制
：这是删除非空目录的关键。如果没有这个选项，
```
fs.rm()
```
登录后复制
会像旧的
```
fs.rmdir()
```
登录后复制
一样，拒绝删除一个包含任何文件或子目录的目录，并抛出
```
ENOTEMPTY
```
登录后复制
错误。
force: true
登录后复制
：这个选项让操作更加“健壮”。如果目标路径不存在，
```
rm
```
登录后复制
操作不会抛出
```
ENOENT
```
登录后复制
错误。这在你尝试删除一个可能已经不存在的目录时非常有用，可以避免不必要的错误处理逻辑。