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方式讀?。∟ode.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格式編寫，包含代碼示例和結構化說明，適合技術博客或文檔使用。如需調整內容長度或細節，可以進一步修改。