NodeJS怎么读取指定的文件和目录

# NodeJS怎么读取指定的文件和目录

在Node.js开发中，文件系统操作是最基础且常用的功能之一。本文将详细介绍如何使用Node.js内置的`fs`模块读取指定文件和目录。

## 一、文件系统模块简介

Node.js通过`fs`模块提供文件系统操作功能，该模块包含同步和异步两种API：

```javascript
const fs = require('fs');          // 同步/异步回调式API
const fsPromises = require('fs').promises; // Promise版本API

二、读取指定文件内容

1. 异步读取文件（推荐）

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

2. 同步读取文件

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

3. Promise方式读取（Node.js 10+）

async function readFile() {
  try {
    const data = await fsPromises.readFile('example.txt', 'utf8');
    console.log('文件内容:', data);
  } catch (err) {
    console.error('读取失败:', err);
  }
}

三、读取目录内容

1. 异步读取目录

fs.readdir('./my-directory', (err, files) => {
  if (err) throw err;
  console.log('目录内容:', files);
});

2. 同步读取目录

try {
  const files = fs.readdirSync('./my-directory');
  console.log('目录内容:', files);
} catch (err) {
  console.error('读取失败:', err);
}

3. 递归读取目录（示例）

const path = require('path');

async function readDirRecursive(dir) {
  const entries = await fsPromises.readdir(dir, { withFileTypes: true });
  
  const files = await Promise.all(entries.map(entry => {
    const fullPath = path.join(dir, entry.name);
    return entry.isDirectory() ? readDirRecursive(fullPath) : fullPath;
  }));
  
  return files.flat();
}

四、高级技巧

1. 使用文件流读取大文件

const readStream = fs.createReadStream('large-file.txt', 'utf8');
readStream.on('data', chunk => console.log('数据块:', chunk));
readStream.on('end', () => console.log('读取完成'));

2. 过滤特定类型文件

const files = fs.readdirSync('./').filter(file => file.endsWith('.js'));

3. 获取文件状态信息

fs.stat('example.txt', (err, stats) => {
  console.log('是否是文件:', stats.isFile());
  console.log('创建时间:', stats.birthtime);
});

五、注意事项

1. 路径处理建议使用path模块跨平台兼容
2. 异步API不会阻塞事件循环，适合生产环境
3. 注意文件权限问题（ENOENT、EACCES错误）
4. 大文件处理推荐使用流(Stream)方式

六、总结

Node.js通过fs模块提供了丰富的文件系统操作方法，开发者可以根据场景选择： - 简单场景：使用readFileSync/readdirSync - 生产环境：推荐异步API或Promise版本 - 特殊需求：结合path、stream等模块实现

掌握这些基础操作后，可以进一步学习文件监听（fs.watch）、文件写入等进阶功能。 “`

这篇文章共计约700字，采用Markdown格式编写，包含代码示例和结构化说明，适合技术博客或文档使用。如需调整内容长度或细节，可以进一步修改。