nodejs怎么读取文件和写文件

发布时间：2021-12-31 14:09:55 作者：iii
来源：亿速云阅读：364

# Node.js怎么读取文件和写文件

## 前言

在Node.js中，文件系统操作是最基础也是最重要的功能之一。无论是读取配置文件、记录日志还是处理用户上传的文件，都需要用到文件读写功能。Node.js通过内置的`fs`模块提供了完整的文件系统操作API，支持同步和异步两种模式。

本文将详细介绍在Node.js中如何实现文件的读取和写入操作，包括：

1. 同步与异步方法的区别
2. 文本文件和二进制文件的处理
3. 大文件的分块读写策略
4. 常用API的详细用法
5. 实际应用中的最佳实践

## 一、文件系统模块基础

Node.js通过`fs`模块提供文件操作功能，使用前需要先引入：

```javascript
const fs = require('fs');

fs模块提供了两套API：

异步API：非阻塞式，通过回调函数返回结果
同步API：阻塞式，立即返回结果（方法名带Sync后缀）

二、读取文件

1. 异步读取文件

fs.readFile('example.txt', 'utf8', (err, data) => {
  if (err) throw err;
  console.log(data);
});

参数说明： - 第一个参数：文件路径 - 第二个参数：编码格式（可选） - 第三个参数：回调函数（err, data）

2. 同步读取文件

try {
  const data = fs.readFileSync('example.txt', 'utf8');
  console.log(data);
} catch (err) {
  console.error(err);
}

3. 读取二进制文件

fs.readFile('image.png', (err, data) => {
  if (err) throw err;
  // data是Buffer对象
  console.log(data);
});

三、写入文件

1. 异步写入文件

const content = 'Hello Node.js';
fs.writeFile('example.txt', content, err => {
  if (err) throw err;
  console.log('文件已保存');
});

2. 同步写入文件

try {
  fs.writeFileSync('example.txt', content);
  console.log('文件已保存');
} catch (err) {
  console.error(err);
}

3. 追加写入文件

fs.appendFile('example.txt', '\nNew content', err => {
  if (err) throw err;
  console.log('内容已追加');
});

四、流式读写大文件

对于大文件，应该使用流(Stream)来避免内存问题：

1. 流式读取

const readStream = fs.createReadStream('largefile.txt', 'utf8');
readStream.on('data', chunk => {
  console.log('读取到数据:', chunk);
}).on('end', () => {
  console.log('读取完成');
});

2. 流式写入

const writeStream = fs.createWriteStream('output.txt');
writeStream.write('第一行\n');
writeStream.write('第二行\n');
writeStream.end();

3. 管道操作

const readStream = fs.createReadStream('input.txt');
const writeStream = fs.createWriteStream('output.txt');
readStream.pipe(writeStream);

五、文件操作高级技巧

1. 同时读写文件

const reader = fs.createReadStream('source.txt');
const writer = fs.createWriteStream('destination.txt');
reader.on('data', chunk => {
  writer.write(chunk.toString().toUpperCase());
});
reader.on('end', () => writer.end());

2. 使用Promise封装

const { promisify } = require('util');
const readFileAsync = promisify(fs.readFile);

async function readFile() {
  try {
    const data = await readFileAsync('example.txt', 'utf8');
    console.log(data);
  } catch (err) {
    console.error(err);
  }
}

3. 使用fs.promises API（Node.js 10+）

const fs = require('fs').promises;

async function example() {
  try {
    const data = await fs.readFile('example.txt', 'utf8');
    await fs.writeFile('copy.txt', data);
  } catch (err) {
    console.error(err);
  }
}

六、错误处理最佳实践

始终检查err参数
使用try-catch处理同步操作
为异步操作添加错误事件监听
处理ENOENT（文件不存在）等常见错误

fs.readFile('nonexistent.txt', (err, data) => {
  if (err) {
    if (err.code === 'ENOENT') {
      console.log('文件不存在');
    } else {
      console.error('未知错误:', err);
    }
    return;
  }
  console.log(data);
});

七、性能考量

小文件：直接使用readFile/writeFile
大文件：使用流式处理
高频操作：考虑内存缓存
同步API会阻塞事件循环，谨慎使用

八、实际应用示例

1. 配置文件读取

async function loadConfig() {
  try {
    const config = await fs.promises.readFile('config.json', 'utf8');
    return JSON.parse(config);
  } catch (err) {
    console.error('加载配置文件失败:', err);
    return null;
  }
}

2. 日志记录系统

function log(message) {
  const timestamp = new Date().toISOString();
  fs.appendFile('app.log', `${timestamp} - ${message}\n`, err => {
    if (err) console.error('写入日志失败:', err);
  });
}

结语

Node.js的文件系统API功能强大而灵活，能够满足各种文件操作需求。掌握这些基础知识后，你可以：

处理各种文件格式（文本、JSON、二进制等）
高效读写不同大小的文件
构建可靠的文件处理流程
开发文件相关的应用程序

记住根据实际场景选择合适的API（同步/异步、回调/Promise/async-await、直接读写/流式处理），并做好错误处理，就能构建出健壮的文件操作代码。 “`

这篇文章详细介绍了Node.js中文件读写的主要方法和注意事项，包含了约1450字的内容，采用Markdown格式编写，涵盖了从基础到高级的各种文件操作技巧。