Node.js 里实现文件写入

在开始编写代码之前，我们需要确保你已经安装了 Node.js 和 npm（Node 包管理器）。你可以通过在终端（或者命令行）中运行以下命令来验证：-

node -v
npm -v

如果 Node.js 和 npm 都已经安装并且版本号正常显示，说明你已经准备好了。

我们将使用 Node.js 的 fs 模块来处理文件系统操作。fs 是 Node.js 的核心模块之一，允许我们与文件系统进行交互，如读取和写入文件。

下面是一个简单的例子，展示了如何使用 Node.js 将一个字符串内容保存到本地的文本文件中：

// 引入 fs 模块
const fs = require('fs');

// 要写入的字符串
const data = '这是一个要写入文件的字符串内容';

// 写入文件
fs.writeFile('output.txt', data, (err) => {
    if (err) {
        console.error('写入文件时发生错误:', err);
    } else {
        console.log('文件已成功写入');
    }
});

这段代码将会在当前目录下创建一个名为 output.txt 的文件，并将指定的字符串内容写入到文件中。如果文件已经存在，它将覆盖文件的内容。如果你希望追加内容而不是覆盖，可以使用 fs.appendFile 方法。

详细步骤解释

1. 引入 fs 模块：在 Node.js 中，fs 模块用于与文件系统进行交互。通过 require('fs') 引入该模块。
2. 定义要写入的字符串：我们定义了一个字符串变量 data，这个变量包含了我们想要写入文件的内容。
3. 写入文件：使用 fs.writeFile 方法将字符串内容写入文件。该方法接收三个参数：文件名、要写入的数据和一个回调函数。在回调函数中，我们处理可能出现的错误，并在文件成功写入后输出一条消息。

处理错误

在进行文件写入操作时，可能会遇到各种错误。例如，权限问题、磁盘空间不足等。为了确保我们的程序能够正确处理这些情况，我们在回调函数中检查了错误 (err) 对象。

if (err) {
    console.error('写入文件时发生错误:', err);
} else {
    console.log('文件已成功写入');
}

如果发生错误，err 对象将包含错误信息，我们使用 console.error 输出错误信息。如果没有错误，表示文件已成功写入。

追加内容到文件

如果你希望将内容追加到文件末尾，而不是覆盖文件内容，可以使用 fs.appendFile 方法：

fs.appendFile('output.txt', data, (err) => {
    if (err) {
        console.error('追加内容时发生错误:', err);
    } else {
        console.log('内容已成功追加到文件');
    }
});

fs.appendFile 的用法与 fs.writeFile 类似，只是它会将内容追加到文件末尾，而不是覆盖文件内容。

同步与异步方法

Node.js 提供了 fs 模块的同步和异步方法。上面的例子中，我们使用的是异步方法。异步方法不会阻塞事件循环，因此更适合处理 I/O 操作。

如果你更喜欢使用同步方法，可以使用 fs.writeFileSync 和 fs.appendFileSync 方法。需要注意的是，同步方法会阻塞事件循环，可能会影响应用的性能，尤其是在处理大量 I/O 操作时。

下面是使用同步方法的例子：

const fs = require('fs');

const data = '这是一个要写入文件的字符串内容';

try {
    fs.writeFileSync('output.txt', data);
    console.log('文件已成功写入');
} catch (err) {
    console.error('写入文件时发生错误:', err);
}

在这个例子中，我们使用了 fs.writeFileSync 方法，该方法会在文件写入完成之前阻塞代码的执行。如果发生错误，会抛出异常，我们使用 try...catch 块来捕获并处理该异常。

创建和使用文件夹

有时，你可能希望将文件保存到一个特定的文件夹中。如果该文件夹不存在，我们可以在写入文件之前创建它：

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

const data = '这是一个要写入文件的字符串内容';
const dir = 'output';

// 检查文件夹是否存在，如果不存在则创建
if (!fs.existsSync(dir)) {
    fs.mkdirSync(dir);
}

// 将文件写入文件夹
const filePath = path.join(dir, 'output.txt');
fs.writeFile(filePath, data, (err) => {
    if (err) {
        console.error('写入文件时发生错误:', err);
    } else {
        console.log('文件已成功写入');
    }
});

在这个例子中，我们使用 fs.existsSync 方法检查文件夹是否存在，如果不存在则使用 fs.mkdirSync 方法创建文件夹。然后，我们使用 path.join 方法构建文件路径，将文件写入该路径。

完整代码示例

最后，让我们将以上所有内容结合在一起，展示一个更完整的示例，包括错误处理、追加内容和文件夹操作：

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

const data = '这是一个要写入文件的字符串内容';
const dir = 'output';

// 检查文件夹是否存在，如果不存在则创建
if (!fs.existsSync(dir)) {
    fs.mkdirSync(dir);
}

// 定义文件路径
const filePath = path.join(dir, 'output.txt');

// 写入文件（覆盖方式）
fs.writeFile(filePath, data, (err) => {
    if (err) {
        console.error('写入文件时发生错误:', err);
    } else {
        console.log('文件已成功写入');
        
        // 追加内容到文件
        const additionalData = '\n这是追加的字符串内容';
        fs.appendFile(filePath, additionalData, (err) => {
            if (err) {
                console.error('追加内容时发生错误:', err);
            } else {
                console.log('内容已成功追加到文件');
            }
        });
    }
});