Bun으로 개발 환경 구축하기 (실험적 기능)

로컬에서 코드를 수정하고 결과를 확인하기까지 걸리는 시간이 길어지면 개발 흐름이 자주 끊기곤 해요. 특히 TypeScript 파일을 실행할 때마다 매번 컴파일 단계를 거쳐야 하는 과정은 생각보다 번거로운 일이죠. 더 빠른 런타임을 통해 개발 피드백 루프를 줄이고 싶은 마음은 모든 개발자가 비슷할 거예요.

이 저장소에서는 Bun을 실험적으로 지원하고 있어요. pnpm 워크플로우를 유지하면서도 로컬에서 TypeScript를 더 빠르게 실행할 수 있는 방법을 소개해 드릴게요.

필요한 것

시작하기 전에 다음 항목이 준비되어 있는지 확인해 주세요.

• Bun (로컬 런타임 및 TypeScript 실행용)
• pnpm (빌드 및 특정 도구 실행용)

빠른 시작

Bun을 사용하여 5분 안에 환경을 구성하는 방법이에요.

1. 의존성 설치 기본적으로 다음 명령어를 사용해요.

   bun install

   만약 bun.lockb 파일이 생성되는 것을 원하지 않는다면 --no-save 옵션을 추가하세요.

   bun install --no-save

2. 프로젝트 빌드

   bun run build

3. 테스트 실행 Vitest를 사용하여 테스트를 진행해요.

   bun run vitest run

문제 해결

Bun을 사용할 때 발생할 수 있는 일반적인 문제와 해결 방법이에요.

Lifecycle Scripts 차단 문제

Bun은 보안을 위해 의존성의 lifecycle scripts 실행을 기본적으로 차단해요. 이 저장소의 주요 패키지들은 이 스크립트 없이도 잘 작동하지만, 만약 런타임 에러가 발생한다면 해당 패키지를 직접 신뢰 목록에 추가해야 해요.

다음 명령어를 실행하여 차단된 스크립트를 허용해 주세요.

bun pm trust @whiskeysockets/baileys protobufjs

주의사항

Bun은 로컬 개발 속도를 높여주지만, 모든 상황에 적합한 것은 아니에요.

• Gateway 런타임 사용 금지: WhatsApp이나 Telegram을 사용하는 Gateway 환경에서는 Bun을 사용하지 마세요. 버그가 발생할 가능성이 높으므로 프로덕션 환경에서는 Node.js 사용을 강력히 추천해요.
• pnpm 전용 스크립트: docs:build, ui:*, protocol:check와 같은 일부 스크립트는 여전히 pnpm을 사용하도록 설정되어 있어요. 이런 스크립트들은 당분간 pnpm으로 실행해 주세요.

설정 과정에서 도움이 필요하다면 AI Setup Assistant에게 물어보세요!

다음 단계

• Node.js 배포 가이드
• pnpm 워크플로우 이해하기