nodejs递归复制文件夹的操作方法

在Node.js中，递归复制文件夹是一个常见的需求，尤其是在构建工具、文件同步或备份等场景中。提供几种解决方案，帮助你实现这一功能。我们将从简单的思路出发，逐步深入，最终提供一个完整的解决方案。

解决方案

为了递归复制文件夹，我们需要遍历源文件夹中的所有文件和子文件夹，并将其逐一复制到目标文件夹中。这通常需要结合fs模块的异步或同步方法来读取目录、创建文件夹以及写入文件内容。以下是的主要思路：
1. 使用fs模块的同步方法实现递归复制。
2. 使用fs.promises结合异步方法实现递归复制。
3. 借助第三方库（如fs-extra）简化操作。

方法一：使用 fs 模块的同步方法

通过fs模块的同步方法，我们可以实现一个简单的递归复制逻辑。这种方法适合对性能要求不高的场景。

实现代码

javascript
const fs = require('fs');
const path = require('path');</p>

<p>function copyDirSync(src, dest) {
    // 确保目标路径存在
    if (!fs.existsSync(dest)) {
        fs.mkdirSync(dest, { recursive: true });
    }</p>

<pre><code>// 读取源目录的内容
const files = fs.readdirSync(src);

files.forEach((file) => {
    const currentSrc = path.join(src, file);
    const currentDest = path.join(dest, file);

    // 判断当前项是文件还是文件夹
    const isDirectory = fs.statSync(currentSrc).isDirectory();

    if (isDirectory) {
        // 如果是文件夹，递归调用
        copyDirSync(currentSrc, currentDest);
    } else {
        // 如果是文件，直接复制
        fs.copyFileSync(currentSrc, currentDest);
    }
});

}

// 示例调用
const srcPath = './source';
const destPath = './destination';

copyDirSync(srcPath, destPath);
console.log('文件夹已成功复制！');

说明

fs.existsSync：检查目标路径是否存在。
fs.mkdirSync：创建目标文件夹（支持递归创建）。
fs.readdirSync：读取目录内容。
fs.statSync：获取文件或文件夹的状态信息。
fs.copyFileSync：复制文件。

方法二：使用 fs.promises 的异步方法

对于更复杂的场景，推荐使用fs.promises模块的异步方法。这种方式可以避免阻塞主线程，并且更容易与其他异步操作集成。

实现代码

javascript
const fs = require('fs').promises;
const path = require('path');</p>

<p>async function copyDir(src, dest) {
    try {
        // 确保目标路径存在
        await fs.mkdir(dest, { recursive: true });</p>

<pre><code>    // 读取源目录的内容
    const files = await fs.readdir(src);

    for (const file of files) {
        const currentSrc = path.join(src, file);
        const currentDest = path.join(dest, file);

        // 获取文件状态
        const stat = await fs.stat(currentSrc);

        if (stat.isDirectory()) {
            // 如果是文件夹，递归调用
            await copyDir(currentSrc, currentDest);
        } else {
            // 如果是文件，复制内容
            const data = await fs.readFile(currentSrc);
            await fs.writeFile(currentDest, data);
        }
    }
} catch (err) {
    console.error('复制文件夹时出错：', err);
}

}

// 示例调用
(async () => {
const srcPath = './source';
const destPath = './destination';

await copyDir(srcPath, destPath);
console.log('文件夹已成功复制！');

})();

说明

fs.mkdir：异步创建文件夹。
fs.readdir：异步读取目录内容。
fs.stat：异步获取文件或文件夹的状态信息。
fs.readFile 和 fs.writeFile：用于读取和写入文件内容。

方法三：使用第三方库 fs-extra

如果你不想自己实现递归复制逻辑，可以借助fs-extra这个强大的第三方库。它提供了许多便捷的方法，包括copy函数，可以直接完成文件夹的递归复制。

安装依赖

安装fs-extra库：
bash npm install fs-extra

实现代码

javascript
const fse = require('fs-extra');
const path = require('path');</p>

<p>(async () => {
    const srcPath = './source';
    const destPath = './destination';</p>

<pre><code>try {
    // 使用 fs-extra 的 copy 方法
    await fse.copy(srcPath, destPath, { overwrite: true });
    console.log('文件夹已成功复制！');
} catch (err) {
    console.error('复制文件夹时出错：', err);
}

})();