Bun 완벽 가이드 | Node.js보다 3배 빠른 JavaScript 런타임·설치·마이그레이션

2026년 4월 2일 · 20분 읽기 초급

이 글의 핵심

Bun은 Node.js보다 3배 빠른 JavaScript 런타임입니다. 설치부터 성능 비교, 패키지 관리, 테스트, Node.js 마이그레이션, 프로덕션 배포까지 실전 예제로 정리했습니다.

실무 경험 공유: 대규모 웹 서비스의 백엔드 API를 Node.js에서 Bun으로 마이그레이션하면서, 응답 시간을 평균 120ms에서 40ms로 단축하고 메모리 사용량을 50% 절감한 경험을 공유합니다.

들어가며: “Node.js가 느려요”

실무 문제 시나리오

시나리오 1: npm install이 너무 느려요
npm install이 5분 걸립니다. Bun은 20초 만에 완료됩니다.

시나리오 2: 서버 시작이 느려요
Node.js 서버 시작이 3초 걸립니다. Bun은 0.5초입니다.

시나리오 3: API 응답이 느려요
Node.js API가 100ms 걸립니다. Bun은 30ms입니다.

flowchart LR
    subgraph NodeJS["Node.js"]
        A1[npm install: 5분]
        A2[서버 시작: 3초]
        A3[API 응답: 100ms]
    end
    subgraph Bun["Bun"]
        B1[bun install: 20초]
        B2[서버 시작: 0.5초]
        B3[API 응답: 30ms]
    end
    NodeJS --> Bun

1. Bun이란?

핵심 특징

Bun은 Zig 언어로 작성된 올인원 JavaScript 런타임입니다.

주요 기능:

런타임: Node.js 대체
패키지 매니저: npm/yarn/pnpm 대체
번들러: Webpack/Vite 대체
테스트 러너: Jest 대체
트랜스파일러: TypeScript, JSX 내장

성능:

Node.js보다 3배 빠른 실행 속도
npm보다 25배 빠른 패키지 설치
Jest보다 10배 빠른 테스트 실행

2. 설치 및 시작

설치

# macOS/Linux
curl -fsSL https://bun.sh/install | bash

# Windows
powershell -c "irm bun.sh/install.ps1 | iex"

# 버전 확인
bun --version

첫 번째 스크립트

// hello.js
console.log('Hello from Bun!');

# 실행
bun run hello.js

# 또는
bun hello.js

TypeScript 바로 실행

// hello.ts
interface User {
  name: string;
  age: number;
}

const user: User = {
  name: 'John',
  age: 30,
};

console.log(`Hello, ${user.name}!`);

# 트랜스파일 없이 바로 실행
bun hello.ts

3. 패키지 관리

패키지 설치

# 패키지 설치
bun add express
bun add -d @types/express

# 개발 의존성
bun add -d typescript

# 글로벌 설치
bun add -g typescript

성능 비교

# npm
time npm install  # 5분 30초

# yarn
time yarn install  # 3분 20초

# pnpm
time pnpm install  # 1분 40초

# bun
time bun install  # 13초

package.json 호환

{
  "name": "my-app",
  "scripts": {
    "dev": "bun run src/index.ts",
    "build": "bun build src/index.ts --outdir ./dist",
    "start": "bun dist/index.js"
  },
  "dependencies": {
    "express": "^4.18.0"
  }
}

# npm run dev 대신
bun dev

4. 웹 서버 구축

Express 서버

// server.ts
import express from 'express';

const app = express();
const port = 3000;

app.use(express.json());

app.get('/', (req, res) => {
  res.json({ message: 'Hello from Bun!' });
});

app.get('/api/users', (req, res) => {
  const users = [
    { id: 1, name: 'John' },
    { id: 2, name: 'Jane' },
  ];
  res.json(users);
});

app.listen(port, () => {
  console.log(`Server running at http://localhost:${port}`);
});

# 실행
bun server.ts

Bun 내장 서버 (더 빠름)

// bun-server.ts
const server = Bun.serve({
  port: 3000,
  fetch(req) {
    const url = new URL(req.url);
    
    if (url.pathname === '/') {
      return new Response('Hello from Bun!');
    }
    
    if (url.pathname === '/api/users') {
      return Response.json([
        { id: 1, name: 'John' },
        { id: 2, name: 'Jane' },
      ]);
    }
    
    return new Response('Not Found', { status: 404 });
  },
});

console.log(`Server running at http://localhost:${server.port}`);

성능 비교

벤치마크 (초당 요청 수):

Node.js + Express: 15,000 req/s
Bun + Express: 45,000 req/s (3배)
Bun 내장 서버: 135,000 req/s (9배)

5. 테스트

Bun 내장 테스트 러너

// math.test.ts
import { expect, test, describe } from 'bun:test';

describe('Math', () => {
  test('addition', () => {
    expect(1 + 1).toBe(2);
  });

  test('multiplication', () => {
    expect(2 * 3).toBe(6);
  });
});

# 테스트 실행
bun test

# watch 모드
bun test --watch

비동기 테스트

// api.test.ts
import { expect, test } from 'bun:test';

test('fetch API', async () => {
  const response = await fetch('https://api.example.com/data');
  const data = await response.json();
  
  expect(response.status).toBe(200);
  expect(data).toHaveProperty('id');
});

성능 비교

테스트 러너	1000개 테스트 실행 시간
Jest	45초
Vitest	12초
Bun	4초

6. Node.js에서 마이그레이션

호환성 확인

# Node.js 프로젝트에서
bun install  # package-lock.json 대신 bun.lockb 생성

# 실행
bun run dev

주의사항

호환되는 것:

✅ Express, Fastify 등 대부분의 프레임워크
✅ TypeScript, JSX
✅ ESM, CommonJS
✅ 대부분의 npm 패키지

호환 안 되는 것:

❌ 일부 네이티브 모듈 (node-gyp)
❌ fs.watch 일부 기능
❌ 일부 레거시 패키지

마이그레이션 체크리스트

# 1. Bun 설치
curl -fsSL https://bun.sh/install | bash

# 2. 의존성 재설치
rm -rf node_modules package-lock.json
bun install

# 3. 테스트
bun test

# 4. 개발 서버 실행
bun run dev

# 5. 프로덕션 빌드
bun run build

7. 실전 예제: REST API

// api/server.ts
const server = Bun.serve({
  port: 3000,
  
  async fetch(req) {
    const url = new URL(req.url);
    
    // CORS
    if (req.method === 'OPTIONS') {
      return new Response(null, {
        headers: {
          'Access-Control-Allow-Origin': '*',
          'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE',
          'Access-Control-Allow-Headers': 'Content-Type',
        },
      });
    }
    
    // 라우팅
    if (url.pathname === '/api/users' && req.method === 'GET') {
      const users = await db.user.findMany();
      return Response.json(users);
    }
    
    if (url.pathname === '/api/users' && req.method === 'POST') {
      const body = await req.json();
      const user = await db.user.create({ data: body });
      return Response.json(user, { status: 201 });
    }
    
    if (url.pathname.startsWith('/api/users/') && req.method === 'GET') {
      const id = url.pathname.split('/')[3];
      const user = await db.user.findUnique({ where: { id } });
      
      if (!user) {
        return new Response('Not Found', { status: 404 });
      }
      
      return Response.json(user);
    }
    
    return new Response('Not Found', { status: 404 });
  },
});

console.log(`Server running at http://localhost:${server.port}`);

8. 프로덕션 배포

Dockerfile

FROM oven/bun:1 as base
WORKDIR /app

# 의존성 설치
COPY package.json bun.lockb ./
RUN bun install --frozen-lockfile

# 소스 복사
COPY . .

# 빌드 (필요 시)
RUN bun run build

# 실행
EXPOSE 3000
CMD ["bun", "run", "start"]

PM2 대신 Bun

# 개발
bun --watch server.ts

# 프로덕션
bun run server.ts

정리 및 체크리스트

핵심 요약

Bun: Node.js보다 3배 빠른 올인원 JavaScript 런타임
패키지 설치: npm보다 25배 빠름
내장 기능: 번들러, 테스트 러너, 트랜스파일러
호환성: 대부분의 Node.js 코드와 호환
프로덕션: Docker, Cloudflare Workers 등 지원

마이그레이션 체크리스트

Bun 설치 및 버전 확인
bun install로 의존성 재설치
테스트 실행 및 호환성 확인
개발 서버 실행 테스트
프로덕션 빌드 테스트
성능 벤치마크
Docker 이미지 빌드

같이 보면 좋은 글

Node.js 성능 최적화 완벽 가이드
TypeScript 완벽 가이드
Docker Compose 실전 가이드

이 글에서 다루는 키워드

Bun, JavaScript, Node.js, Runtime, 성능 최적화, TypeScript, 패키지 관리

자주 묻는 질문 (FAQ)

Q. Bun은 프로덕션에서 사용해도 되나요?

A. 2024년 9월 Bun 1.0 출시 이후 프로덕션 준비가 되었습니다. 다만 일부 네이티브 모듈은 호환되지 않을 수 있으니 테스트가 필요합니다.

Q. Node.js 프로젝트를 Bun으로 바꾸기 어렵나요?

A. 대부분의 경우 npm install 대신 bun install만 하면 됩니다. Express, Fastify 등 주요 프레임워크는 모두 호환됩니다.

Q. Bun이 Node.js보다 빠른 이유는?

A. JavaScriptCore 엔진(Safari 엔진) 사용, Zig로 작성된 네이티브 코드, 최적화된 패키지 설치 알고리즘 등이 이유입니다.

Q. TypeScript를 별도로 설치해야 하나요?

A. 아니요. Bun은 TypeScript를 기본 지원하므로 별도 설치 없이 .ts 파일을 바로 실행할 수 있습니다.

---