Node.js中如何读写文件

在Node.js中，文件操作是非常常见的任务之一。无论是读取配置文件、写入日志，还是处理用户上传的文件，都需要用到文件读写操作。Node.js提供了内置的fs模块（文件系统模块），使得文件操作变得非常简单。本文将详细介绍如何在Node.js中读写文件。

1. 引入fs模块

在开始之前，首先需要引入Node.js的fs模块。fs模块提供了同步和异步两种方式来操作文件。

const fs = require('fs');

2. 读取文件

2.1 异步读取文件

异步读取文件是最常用的方式，因为它不会阻塞程序的执行。fs.readFile()方法用于异步读取文件内容。

fs.readFile('example.txt', 'utf8', (err, data) => {
    if (err) {
        console.error('读取文件时出错:', err);
        return;
    }
    console.log('文件内容:', data);
});

• 'example.txt'：要读取的文件路径。
• 'utf8'：指定文件的编码格式，通常使用utf8来读取文本文件。
• (err, data) => {}：回调函数，当文件读取完成后调用。err为错误对象，data为文件内容。

2.2 同步读取文件

同步读取文件会阻塞程序的执行，直到文件读取完成。fs.readFileSync()方法用于同步读取文件内容。

try {
    const data = fs.readFileSync('example.txt', 'utf8');
    console.log('文件内容:', data);
} catch (err) {
    console.error('读取文件时出错:', err);
}

• fs.readFileSync()：同步读取文件内容，返回文件内容。
• try...catch：用于捕获可能的错误。

3. 写入文件

3.1 异步写入文件

异步写入文件使用fs.writeFile()方法。如果文件不存在，则会创建该文件；如果文件已存在，则会覆盖原有内容。

const content = '这是要写入文件的内容。';
fs.writeFile('example.txt', content, 'utf8', (err) => {
    if (err) {
        console.error('写入文件时出错:', err);
        return;
    }
    console.log('文件写入成功');
});

• 'example.txt'：要写入的文件路径。
• content：要写入的内容。
• 'utf8'：指定文件的编码格式。
• (err) => {}：回调函数，当文件写入完成后调用。err为错误对象。

3.2 同步写入文件

同步写入文件使用fs.writeFileSync()方法。

const content = '这是要写入文件的内容。';
try {
    fs.writeFileSync('example.txt', content, 'utf8');
    console.log('文件写入成功');
} catch (err) {
    console.error('写入文件时出错:', err);
}

• fs.writeFileSync()：同步写入文件内容。

4. 追加内容到文件

有时候我们需要在文件末尾追加内容，而不是覆盖原有内容。可以使用fs.appendFile()方法。

4.1 异步追加内容

const appendContent = '\n这是追加的内容。';
fs.appendFile('example.txt', appendContent, 'utf8', (err) => {
    if (err) {
        console.error('追加内容时出错:', err);
        return;
    }
    console.log('内容追加成功');
});

4.2 同步追加内容

const appendContent = '\n这是追加的内容。';
try {
    fs.appendFileSync('example.txt', appendContent, 'utf8');
    console.log('内容追加成功');
} catch (err) {
    console.error('追加内容时出错:', err);
}

5. 删除文件

删除文件使用fs.unlink()方法。

5.1 异步删除文件

fs.unlink('example.txt', (err) => {
    if (err) {
        console.error('删除文件时出错:', err);
        return;
    }
    console.log('文件删除成功');
});

5.2 同步删除文件

try {
    fs.unlinkSync('example.txt');
    console.log('文件删除成功');
} catch (err) {
    console.error('删除文件时出错:', err);
}

6. 总结

Node.js的fs模块提供了丰富的API来进行文件操作，包括读取、写入、追加和删除文件等。根据实际需求，可以选择使用同步或异步的方式来进行文件操作。异步操作不会阻塞程序的执行，适合处理I/O密集型任务；而同步操作则适合在需要确保文件操作完成后再执行后续代码的场景。

通过本文的介绍，你应该已经掌握了如何在Node.js中进行文件读写操作。在实际开发中，可以根据具体需求选择合适的文件操作方法。