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

bun

Bun

설치

명령어 매핑