OS와 공식 설치

공식 문서는 macOS·Linux·Windows 설치를 안내합니다. Windows는10 버전1809 이상 조건을 확인합니다. Linux 설치에는 unzip 등이 관련되며 권장 커널과 오래된 커널의 제한을 나눠 읽습니다.

Windows에서는 PowerShell을 열어 다음 공식 설치 명령을 사용합니다. 원격 설치 스크립트를 실행하고 사용자 기기에 Bun을 설치하는 명령입니다.

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

macOS·Linux에서는 bash 계열 터미널에서 다음 명령을 사용합니다.

curl -fsSL https://bun.com/install | bash

Linux에는 unzip이 필요하며 공식 권장 커널은 5.6 이상입니다. 설치가 끝나면 새 터미널을 열어 아래 버전을 확인하세요. 명령을 못 찾으면 기본 설치 폴더인 ~/.bun/bin의 PATH 등록을 확인합니다. 공식 설치 문서의 OS별 명령을 기준으로 했으며 이 글에서 설치를 실제 실행하지는 않았습니다.

경로와 버전 확인

설치 뒤 새 셸에서 다음과 같은 확인을 할 수 있습니다. 명령을 찾을 수 없다면 설치 실패와 PATH·셸 재시작 문제를 구분합니다.

bun --version
bun --revision

일반 node --version의 출력은 Bun 설치 확인이 아닙니다. 여러 실행 파일·패키지 관리자·프로젝트 설정을 동시에 바꾸면 원인을 나누기 어려우므로 먼저 어떤 도구를 호출하는지 확인합니다.

첫 TypeScript 예시

직접 만든 시험 폴더에 아래 내용을 hello.ts로 저장하는 경우를 생각해 보세요. 사이트에서 제공하는 다운로드 파일은 없으며 본문에서 읽고 복사할 수 있는 자체 예시입니다.

const quantities: number[] = [2, 3];
const total = quantities.reduce((sum, value) => sum + value, 0);
console.log(`total=${total}`);

해당 폴더에서 bun run hello.ts로 실행하는 흐름입니다. 산술상 기대 문자열은 total=5지만 실제 Bun 실행 로그를 제시한 것은 아닙니다. 파일 저장 위치와 실행한 작업 폴더가 일치하는지 확인합니다.

실행과 타입 검사 구분

짧은 예시의 출력이 맞는 것과 프로젝트 전체의 타입·테스트가 통과하는 것은 다릅니다. 공식 TypeScript 문서는 @types/bun과 tsconfig 설정을 별도로 안내합니다. Bun 내장 API의 편집기 타입 표시와 실제 실행도 나눠 확인합니다.

Node API·네이티브 패키지·설치 스크립트 등이 있는 기존 프로젝트는 호환 범위를 읽습니다. “Node 대안”이라는 소개를 모든 프로젝트가 수정 없이 같은 결과를 낸다는 보장으로 바꾸지 않습니다.

패키지 작업은 다음 단계

런타임이 준비된 뒤 의존성·잠금 파일을 바꿀지 판단합니다. bun install은 실행 파일 확인과 달리 프로젝트·캐시·다운로드에 영향을 줄 수 있습니다. 기존 npm·Yarn·pnpm 잠금을 보존한 상태에서 별도 과업으로 검토합니다.

공식 설치·TypeScript 안내와 자체 합계 예시를 검토했습니다. 실제 Bun 설치·실행·패키지 다운로드·타입 검사·테스트·프로젝트 변경은 미실행입니다. 개인 코드·셸 설정도 사용하지 않았습니다.

목적별 가이드

하려는 일 가이드
의존성과 잠금 파일 이전 Bun 패키지·잠금
Node.js 환경부터 확인 Node.js
다른 런타임의 권한 확인 Deno

참고 자료