[JavaScript] Bun (Runtime + Bundler)

Bun, bun, Bun runtime, Bun bundler, bun install, Bun.build

정의

Bun 은 Jarred Sumner 가 2022년 발표한 JavaScript/TypeScript 런타임 + 번들러 + 패키지 매니저 + 테스트 러너 통합 도구입니다. Zig 로 작성되어 Node.js/npm 대비 압도적 성능.

한 줄 요약: Node + npm + Webpack + Jest 를 하나의 초고속 도구로.

구성 요소

Bun 은 여러 도구를 하나로:

• bun 런타임: Node.js 대체
• bun install: npm/yarn/pnpm 대체
• bun run: node 실행
• bun test: Jest 대체
• bun build / Bun.build(): 번들러
• bunx: npx 대체

왜 Zig 인가

• Rust 보다 러닝커브 낮음
• C 와 상호운용 우수
• 컴파일 시간 빠름
• 저수준 제어 (JavaScriptCore 통합)

Node 가 V8 + libuv + C++ 인 것과 대비되게, Bun 은 JavaScriptCore (Safari) + Zig 조합.

번들러 사용

CLI

bun build ./src/index.ts \
  --outdir=dist \
  --minify \
  --sourcemap \
  --target=browser

API

await Bun.build({
  entrypoints: ['./src/index.ts'],
  outdir: './dist',
  minify: true,
  sourcemap: 'external',
  target: 'browser',
  format: 'esm',
  external: ['react'],
  plugins: [/* ... */],
});

특징

TypeScript 네이티브

.ts 를 별도 설치 없이 실행/번들:

bun run src/main.ts   # 그냥 됨

esbuild/SWC 처럼 type check 는 X (bun tsc --noEmit 별도).

JSX 네이티브

.tsx, .jsx 즉시 지원. React/Preact/Solid 등.

CSS 지원

CSS import 기본 지원. PostCSS 는 plugin 필요.

Dead Code Elimination + Tree Shaking

ESM 기반, esbuild 급.

Import Attributes

import config from './config.json' with { type: 'json' };

패키지 매니저 (bun install)

node_modules 관리:

• 속도: npm 대비 20-30x, pnpm 대비 2-3x
• 호환: package.json 표준
• Lockfile: bun.lock (텍스트 형식)
• Workspace: 모노레포 지원

bun install
bun add react
bun add -d typescript
bun remove react

런타임

Node.js 호환

대부분 Node.js API 지원. 몇몇 예외 (worker_threads 부분 지원, 일부 native module).

Bun 자체 API

// HTTP 서버 (Express 없이)
Bun.serve({
  port: 3000,
  fetch(req) {
    return new Response('Hello');
  },
});

// 파일 IO
const file = Bun.file('./data.json');
const json = await file.json();

// 파일 쓰기
await Bun.write('./out.txt', 'content');

// SQLite (bundled)
import { Database } from 'bun:sqlite';
const db = new Database('mydb.sqlite');

성능

• HTTP throughput: Node 대비 3-4x
• Startup time: 매우 빠름
• Memory usage: 낮음

번들러 vs esbuild

공통점:

• ESM 기반 tree shaking
• TypeScript/JSX 즉시
• 초고속

차이점:

• Bun 은 통합 스택 (런타임 + 매니저 + 테스트 + 번들러)
• esbuild 는 순수 번들러/트랜스파일러

사용 사례

1. Node.js 앱 대체

bun install
bun run src/server.ts

Node → Bun 전환. 대부분 앱 즉시 작동.

2. TypeScript 스크립트

bun run scripts/generate.ts   # tsx, ts-node 대체

3. 모노레포

// package.json
{
  "workspaces": ["packages/*"]
}

bun install 이 워크스페이스 링크 관리.

4. 라이브러리 빌드

{
  "scripts": {
    "build": "bun build ./src/index.ts --outdir=dist --format=esm --external=*"
  }
}

Rollup/tsup 대체.

5. 테스트

bun test

Jest 호환 API (일부).

프로덕션 사용

적합:

• 새 프로젝트
• Node 앱 (서버, CLI, 스크립트)
• 모노레포
• CI 스크립트

주의:

• 일부 Node.js API 미지원 (특히 legacy)
• Native module (.node 파일) 호환성 이슈
• 아직 Node 만큼 배포 검증 축적 안 됨
• Jest snapshot 등 일부 테스트 도구 이관 필요

함정

관련 위키

• JS 번들링 개요
• Webpack
• Vite
• esbuild
• Rollup
• Turbopack & Rspack
• CJS vs ESM
• TypeScript