Node.js讀取和寫入文件的代碼示例

更新時間：2024年11月07日 10:05:49 作者：JJCTO袁龍

在現(xiàn)代前端開發(fā)中,Node.js已經成為不可或缺的一部分,其高效的非阻塞I/O模型使得它非常適合處理文件操作,在這篇博客中,我們將探討如何使用Node.js讀取和寫入文件,我們會涉及基本的文件系統(tǒng)模塊,并提供可運行的代碼示例,以便您可以輕松上手

1. Node.js文件系統(tǒng)模塊概述

Node.js提供了一個內置的fs模塊（文件系統(tǒng)模塊），用于對文件和目錄進行操作。通過該模塊，你可以執(zhí)行讀、寫、刪除、重命名等文件操作。

在使用fs模塊之前，確保你的Node.js環(huán)境已正確安裝。你可以在終端中運行以下命令來確認是否已成功安裝Node.js：

node -v

如果你看到Node.js的版本號，說明環(huán)境已經配置好了。

2. 讀取文件

接下來，我們將看看如何讀取文件。在Node.js中，你可以使用fs.readFile()方法讀取文件內容。此方法支持異步和同步讀取。

示例代碼：異步讀取文件

首先，我們使用異步方法讀取文件內容。假設我們有一個名為example.txt的文件，內容如下：

Hello, Node.js!
Welcome to file operations.

以下是異步讀取該文件的代碼示例：

const fs = require('fs');

// 異步讀取文件
fs.readFile('example.txt', 'utf8', (err, data) => {
  if (err) {
    console.error('讀取文件時發(fā)生錯誤:', err);
    return;
  }
  console.log('文件內容:', data);
});

示例代碼：同步讀取文件

如果你想要使用同步讀取，可以使用fs.readFileSync()方法。請注意，使用同步方法在文件較大時可能會造成阻塞，因此不建議在生產環(huán)境中使用。

const fs = require('fs');

try {
  const data = fs.readFileSync('example.txt', 'utf8');
  console.log('文件內容:', data);
} catch (err) {
  console.error('讀取文件時發(fā)生錯誤:', err);
}

3. 寫入文件

在Node.js中，可以使用fs.writeFile()和fs.appendFile()來寫入文件。fs.writeFile()會覆蓋文件內容，而fs.appendFile()則會在文件末尾添加內容。

示例代碼：寫入文件

以下是fs.writeFile()異步寫入文件的代碼示例：

const fs = require('fs');

const content = '這是一段寫入到文件中的文本。';

// 異步寫入文件
fs.writeFile('output.txt', content, (err) => {
  if (err) {
    console.error('寫入文件時發(fā)生錯誤:', err);
    return;
  }
  console.log('文件寫入成功!');
});

示例代碼：追加到文件

如果你希望將內容追加到已有文件中，則可以使用fs.appendFile()方法：

const fs = require('fs');

const additionalContent = '這段文本將被追加到文件的末尾。';

// 異步追加文件
fs.appendFile('output.txt', additionalContent, (err) => {
  if (err) {
    console.error('追加文件時發(fā)生錯誤:', err);
    return;
  }
  console.log('內容成功追加到文件!');
});

4. 錯誤處理

在進行文件讀取和寫入操作時，錯誤處理是非常重要的。你可以通過檢查err參數(shù)來處理讀取和寫入過程中可能出現(xiàn)的錯誤。常見的錯誤包括文件不存在、權限不足等。

示例代碼：處理文件錯誤

以下是一個完整的例子，包括錯誤處理：

const fs = require('fs');

// 異步讀取文件并處理錯誤
fs.readFile('nonexistent.txt', 'utf8', (err, data) => {
  if (err) {
    console.error('讀取文件時發(fā)生錯誤:', err.message);
    return;
  }
  console.log('文件內容:', data);
});

// 異步寫入新文件并處理錯誤
fs.writeFile('newfile.txt', '這是新文件的內容。', (err) => {
  if (err) {
    console.error('寫入文件時發(fā)生錯誤:', err.message);
    return;
  }
  console.log('文件寫入成功!');
});