Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行环境，它提供了许多内置的模块和功能，使得在服务器端开发变得更加容易和高效。其中，文件系统（fs）模块是 Node.js 中用于处理文件的核心模块之一，它提供了一系列的方法来读取和写入文件。在本文中，我们将介绍如何在 Node.js 中高效地读写 JSON 文件。
一、读取 JSON 文件
要读取一个 JSON 文件，我们可以使用 `fs.readFile()` 方法。这个方法接受两个参数：文件路径和回调函数。文件路径是要读取的 JSON 文件的路径，回调函数接受两个参数：错误对象和文件内容。如果读取文件时发生错误，错误对象将不为 null；如果读取成功，文件内容将以字符串的形式传递给回调函数。
以下是一个读取 JSON 文件的示例代码：
```javascript
const fs = require('fs');
fs.readFile('data.json', 'utf8', (err, data) => {
if (err) {
console.error(err);
return;
}
try {
const jsonData = JSON.parse(data);
console.log(jsonData);
} catch (error) {
console.error('Failed to parse JSON:', error);
}
});
```
在上面的代码中，我们首先使用 `require()` 方法引入了 `fs` 模块。然后，我们使用 `fs.readFile()` 方法读取了 `data.json` 文件的内容，并将其传递给回调函数。在回调函数中，我们首先检查是否发生了错误，如果发生了错误，我们将打印错误信息并返回。如果没有发生错误，我们将使用 `JSON.parse()` 方法将字符串解析为 JSON 对象，并将其打印出来。
需要注意的是，`fs.readFile()` 方法是异步的，这意味着它不会阻塞代码的执行。当读取文件时，Node.js 将继续执行其他代码，直到文件读取完成后才会调用回调函数。因此，如果需要在读取文件后执行其他操作，我们需要将这些操作放在回调函数中。
二、写入 JSON 文件
要写入一个 JSON 文件，我们可以使用 `fs.writeFile()` 方法。这个方法接受三个参数：文件路径、要写入的内容和回调函数。文件路径是要写入的 JSON 文件的路径，要写入的内容是一个 JSON 对象或字符串，回调函数接受一个参数：错误对象。如果写入文件时发生错误，错误对象将不为 null；如果写入成功，错误对象将为 null。
以下是一个写入 JSON 文件的示例代码：
```javascript
const fs = require('fs');
const jsonData = { name: 'John', age: 30 };
fs.writeFile('data.json', JSON.stringify(jsonData), (err) => {
if (err) {
console.error(err);
return;
}
console.log('JSON file written successfully.');
});
```
在上面的代码中，我们首先定义了一个 JSON 对象 `jsonData`，然后使用 `fs.writeFile()` 方法将其写入 `data.json` 文件中。在写入文件时，我们使用 `JSON.stringify()` 方法将 JSON 对象转换为字符串，以确保文件内容是合法的 JSON 格式。
需要注意的是，`fs.writeFile()` 方法也是异步的，它不会阻塞代码的执行。当写入文件时，Node.js 将继续执行其他代码，直到文件写入完成后才会调用回调函数。如果需要在写入文件后执行其他操作，我们需要将这些操作放在回调函数中。
三、高效读写 JSON 文件的技巧
1. 使用异步操作：由于文件系统操作是异步的，我们应该尽量使用异步方法来读取和写入文件，以避免阻塞代码的执行。例如，使用 `fs.readFile()` 和 `fs.writeFile()` 方法而不是同步方法 `fs.readFileSync()` 和 `fs.writeFileSync()`。
2. 缓存文件内容：如果需要多次读取同一个 JSON 文件，我们可以将文件内容缓存到内存中，以避免重复读取文件。可以使用一个全局变量或对象来存储文件内容，并在需要时直接使用它。
3. 批量操作：如果需要对多个 JSON 文件进行读写操作，我们可以考虑批量操作，以提高效率。例如，可以将多个文件的读取操作合并为一个操作，或者将多个文件的写入操作合并为一个操作。
4. 错误处理：在读写 JSON 文件时，可能会发生各种错误，如文件不存在、权限问题等。我们应该在代码中进行适当的错误处理，以确保程序的稳定性和可靠性。可以使用 `try-catch` 语句来捕获错误，并在发生错误时进行相应的处理。
四、总结
在 Node.js 中，读写 JSON 文件是一个常见的任务。通过使用 `fs` 模块提供的方法，我们可以轻松地读取和写入 JSON 文件。为了提高读写效率，我们可以使用异步操作、缓存文件内容、批量操作和错误处理等技巧。在实际开发中，我们可以根据具体的需求和场景选择合适的方法来读写 JSON 文件，以提高程序的性能和用户体验。
浙公网安备 33059102000262号