Làm việc với hệ thống file trong Node như thế nào?

Question

Accepted Answer

Module tích hợp **`fs`** đọc và ghi file và thư mục. Nó cung cấp ba kiểu API — **promises** (hiện đại, được ưu tiên), **callbacks** (bất đồng bộ gốc), và **sync** (chặn) — để bạn chọn đúng kiểu cho từng tình huống.

## API promise (khuyến nghị)

```js
import { readFile, writeFile, mkdir, readdir } from "fs/promises";

async function work() {
  const data = await readFile("input.txt", "utf8");     // đọc (utf8 → chuỗi)
  await writeFile("output.txt", "Hello");                // ghi (đè)
  await mkdir("new-dir", { recursive: true });           // tạo thư mục (recursive = mkdir -p)
  const files = await readdir("./");                      // liệt kê nội dung thư mục
}
```

API `fs/promises` hoạt động gọn với async/await — mặc định hiện đại cho I/O file.

## Biến thể callback và sync

```js
import fs from "fs";

fs.readFile("file.txt", "utf8", (err, data) => { ... }); // callback bất đồng bộ
const data = fs.readFileSync("file.txt", "utf8");         // SYNC — chặn event loop!
```

**Cảnh báo:** các phương thức `*Sync` **chặn toàn bộ event loop** cho tới khi thao tác xong. Chúng ổn lúc khởi động (nạp cấu hình một lần) nhưng nên tránh trong các request handler — một lần đọc chặn sẽ đóng băng mọi request đồng thời.

## Các thao tác thường gặp

```js
await fs.promises.appendFile("log.txt", "new line
"); // nối thêm
await fs.promises.unlink("old.txt");                    // xóa file
await fs.promises.rename("a.txt", "b.txt");             // đổi tên/di chuyển
const stats = await fs.promises.stat("file.txt");       // metadata (size, mtime)
const exists = fs.existsSync("file.txt");               // kiểm tra tồn tại
```

## Với file lớn: dùng streams

```js
// ❌ readFile nạp TOÀN BỘ file vào bộ nhớ — tệ với file rất lớn
const huge = await readFile("10gb.txt"); // có thể cạn bộ nhớ

// ✅ stream theo từng chunk (bộ nhớ cố định)
fs.createReadStream("10gb.txt").pipe(fs.createWriteStream("copy.txt"));
```

Với file lớn, `readFile` nạp mọi thứ vào bộ nhớ cùng lúc; **streams** xử lý dữ liệu theo từng chunk với bộ nhớ cố định.

## Tại sao điều này quan trọng

I/O file là một khả năng cốt lõi của Node cho việc nạp cấu hình, ghi log, upload/download file và công cụ.

Biết ba kiểu API — và quan trọng là **các phương thức sync chặn event loop** (tránh chúng trong server) và **file lớn cần streams** (không phải `readFile`) — là thiết yếu để viết code xử lý file vừa đúng vừa hiệu năng dưới tải đồng thời.

API promise với async/await là mặc định gọn cho dùng hằng ngày.