Node에서 파일 시스템을 어떻게 다루나요?

Question

Accepted Answer

내장 **`fs`** 모듈은 파일과 디렉터리를 읽고 씁니다. 세 가지 API 스타일을 제공합니다. **promise**(현대적이고 권장됨), **callback**(최초의 비동기), **sync**(블로킹)로, 상황에 맞는 것을 고를 수 있습니다.

## promise API(권장)

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

async function work() {
  const data = await readFile("input.txt", "utf8");     // read (utf8 → string)
  await writeFile("output.txt", "Hello");                // write (overwrites)
  await mkdir("new-dir", { recursive: true });           // create dirs (recursive = mkdir -p)
  const files = await readdir("./");                      // list directory contents
}
```

`fs/promises` API는 async/await와 깔끔하게 동작합니다. 파일 I/O의 현대적 기본입니다.

## callback 및 sync 변형

```js
import fs from "fs";

fs.readFile("file.txt", "utf8", (err, data) => { ... }); // async callback
const data = fs.readFileSync("file.txt", "utf8");         // SYNC — blocks the event loop!
```

**주의:** `*Sync` 메서드는 작업이 끝날 때까지 **event loop 전체를 블로킹**합니다. 시작 시점(설정을 한 번 로드)에는 괜찮지만 요청 핸들러에서는 피해야 합니다. 블로킹 읽기는 모든 동시 요청을 멈춥니다.

## 흔한 작업

```js
await fs.promises.appendFile("log.txt", "new line
"); // append
await fs.promises.unlink("old.txt");                    // delete a file
await fs.promises.rename("a.txt", "b.txt");             // rename/move
const stats = await fs.promises.stat("file.txt");       // metadata (size, mtime)
const exists = fs.existsSync("file.txt");               // check existence
```

## 대용량 파일: stream 사용

```js
// ❌ readFile loads the WHOLE file into memory — bad for huge files
const huge = await readFile("10gb.txt"); // could exhaust memory

// ✅ stream it in chunks (constant memory)
fs.createReadStream("10gb.txt").pipe(fs.createWriteStream("copy.txt"));
```

큰 파일의 경우 `readFile`은 모든 것을 한 번에 메모리에 적재합니다. **stream**은 데이터를 일정한 메모리로 청크 단위로 처리합니다.

## 왜 중요한가

파일 I/O는 설정 로딩, 로깅, 파일 업로드/다운로드, 도구 제작을 위한 Node의 핵심 기능입니다.

세 가지 API 스타일을 아는 것, 그리고 무엇보다 **sync 메서드가 event loop를 블로킹한다는 점**(서버에서는 피할 것)과 **대용량 파일은 stream이 필요하다는 점**(`readFile`이 아님)을 아는 것은 동시성 환경에서 올바르고 성능 좋은 파일 처리 코드를 작성하는 데 필수적입니다.

async/await와 함께 쓰는 promise API가 일상적인 사용의 깔끔한 기본입니다.