Bun

Node.js 대신 Bun을 기본 런타임으로 사용.

설치

# macOS / Linux
brew install oven-sh/bun/bun

# npm
npm install -g bun

명령어 매핑

Node.js / npm	Bun
npm install	bun install
npm install <pkg>	bun add <pkg>
npm install -D <pkg>	bun add -d <pkg>
npm uninstall <pkg>	bun remove <pkg>
npm run <script>	bun run <script> 또는 bun <script>
npx <cmd>	bunx <cmd>
node <file>	bun <file>
npm init	bun init
npm create <template>	bun create <template>

프로젝트 초기화

# 새 프로젝트
bun init

# 템플릿 사용
bun create next-app my-app
bun create vite my-app

패키지 관리

# 설치 (bun.lockb 생성)
bun install

# 의존성 추가
bun add express zod
bun add -d typescript @types/node  # devDependencies

# 삭제
bun remove lodash

lockfile: bun.lockb (바이너리). .gitignore에 추가하지 않음.

스크립트 실행

# package.json scripts
bun run dev
bun run build

# 파일 직접 실행 (TypeScript 지원)
bun index.ts
bun src/server.ts

# 단축 (run 생략 가능)
bun dev

주의 사항

1. 패키지 설치 전 이름 확인

# ❌ 오타 또는 유사 패키지 - 타이포스쿼팅 위험
bun add expres
bun add lodassh

# ✅ 정확한 패키지명 확인 후 설치
bun add express
bun add lodash

bun add 실행 전 패키지명이 정확한지 확인. npm 레지스트리에 유사한 이름의 악성 패키지가 등록될 수 있음.

2. 신뢰할 수 없는 스크립트 실행 금지

# ❌ 출처 불명의 스크립트 직접 실행
bun run https://example.com/script.ts
curl -fsSL https://example.com/install.sh | bash

# ✅ 로컬 프로젝트 내 스크립트만 실행
bun run src/index.ts
bun run dev

원격 스크립트나 검증되지 않은 파일은 직접 실행하지 않음.

GitHub Actions

- uses: oven-sh/setup-bun@v{N} # 최신 버전 확인: gh api repos/oven-sh/setup-bun/releases/latest --jq '.tag_name'
- run: bun install
- run: bun test