bun*: add Korean translation (#21683)

2026-08-28 20:11:19 +08:00 · 2026-03-24 23:25:13 +09:00
parent 152e825316
commit 00fd281cd4
26 changed files with 576 additions and 0 deletions
@@ -0,0 +1,20 @@
+# bun-info
+
+> npm 레지스트리에서 패키지 메타데이터를 조회.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/info>.
+
+- 패키지 메타데이터 출력:
+
+`bun info {{패키지_이름}}`
+
+- 특정 버전의 메타데이터 출력:
+
+`bun info {{패키지_이름}}@{{버전}}`
+
+- 패키지의 특정 속성 출력:
+
+`bun info {{패키지_이름}} {{프로퍼티}}`
+
+- JSON 형식으로 결과 출력:
+
+`bun info {{패키지_이름}} --json`
@@ -0,0 +1,32 @@
+# bun init
+
+> 빈 Bun 프로젝트를 생성(스캐폴딩).
+> 더 많은 정보: <https://bun.com/docs/runtime/templating/init>.
+
+- 현재 디렉토리에서 Bun 프로젝트 초기화:
+
+`bun init`
+
+- 특정 디렉토리에서 초기화:
+
+`bun init {{경로/대상/디렉토리}}`
+
+- 특정 프로젝트 이름으로 초기화:
+
+`bun init {{[-n|--name]}} {{프로젝트_이름}}`
+
+- 기본 프롬프트로 프로젝트 초기화:
+
+`bun init {{[-y|--yes]}}`
+
+- 최소 구성 프로젝트 초기화:
+
+`bun init {{[-m|--minimal]}}`
+
+- React 프로젝트 초기화:
+
+`bun init {{[-r|--react]}}`
+
+- Tailwind CSS가 포함된 React 프로젝트 초기화:
+
+`bun init --react=tailwind`
@@ -0,0 +1,28 @@
+# bun install
+
+> `package.json`에 정의된 JavaScript 의존성을 설치.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/install>.
+
+- `package.json`에 나열된 모든 의존성 설치:
+
+`bun {{[i|install]}}`
+
+- 단일 패키지 설치 (`bun add`의 별칭):
+
+`bun {{[i|install]}} {{패키지_이름}}@{{버전}}`
+
+- 패키지를 전역으로 설치:
+
+`bun {{[i|install]}} {{[-g|--global]}} {{패키지_이름}}`
+
+- 프로덕션 의존성만 설치 (`devDependencies` 제외):
+
+`bun {{[i|install]}} {{[-p|--production]}}`
+
+- `bun.lockb` 파일 기준으로 정확히 의존성 설치 (lockfile 고정):
+
+`bun {{[i|install]}} --frozen-lockfile`
+
+- 캐시를 무시하고 모든 패키지를 강제로 다시 다운로드:
+
+`bun {{[i|install]}} {{[-f|--force]}}`
@@ -0,0 +1,25 @@
+# bun link
+
+> 로컬 패키지를 링크 가능한 상태로 등록하거나, 등록된 패키지를 프로젝트에 연결.
+> 관련 항목: `bun unlink`.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/link>.
+
+- 현재 패키지를 전역으로 링크:
+
+`bun link`
+
+- 패키지를 프로젝트에 로컬로 링크:
+
+`bun link {{패키지_이름}}`
+
+- 특정 디렉토리에 있는 패키지를 링크:
+
+`bun link --cwd {{경로/대상/패키지}}`
+
+- 실제로 링크하지 않고 시뮬레이션(dry run)만 진행:
+
+`bun link --dry-run`
+
+- 도움말 출력:
+
+`bun link {{[-h|--help]}}`
@@ -0,0 +1,24 @@
+# bun outdated
+
+> 최신 버전이 존재하는 의존성 목록을 확인.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/outdated>.
+
+- 현재 프로젝트의 모든 오래된 의존성 목록 출력:
+
+`bun outdated`
+
+- 특정 패키지가 오래되었는지 확인:
+
+`bun outdated {{패키지}}`
+
+- glob 패턴에 일치하는 오래된 의존성 목록 출력:
+
+`bun outdated "{{패턴}}"`
+
+- 특정 워크스페이스에 대한 오래된 의존성 목록 출력 :
+
+`bun outdated {{[-F|--filter]}} "{{작업공간_패턴}}"`
+
+- 모노레포의 모든 워크스페이스를 재귀적으로 검사:
+
+`bun outdated {{[-r|--recursive]}}`
@@ -0,0 +1,24 @@
+# bun patch
+
+> 패키지를 수정할 수 있도록 준비하거나, 패치 파일을 생성 .
+> 더 많은 정보: <https://bun.com/docs/pm/cli/patch>.
+
+- 패키지를 수정할 수 있도록 준비:
+
+`bun patch {{패키지}}`
+
+- 특정 버전의 패키지를 수정할 수 있도록 준비:
+
+`bun patch {{패키지}}@{{버전}}`
+
+- 특정 경로에 있는 패키지를 수정할 수 있도록 준비:
+
+`bun patch {{경로/대상/패키지}}`
+
+- 패키지에 적용한 변경 사항으로 패치 파일 생성:
+
+`bun patch --commit {{경로/대상/패키지}}`
+
+- 패치 파일을 생성하고 사용자 지정 디렉토리에 저장:
+
+`bun patch --commit {{경로/대상/패키지}} --patches-dir {{경로/대상/디렉토리}}`
@@ -0,0 +1,12 @@
+# bun pm bin
+
+> `bin` 디렉토리의 경로를 출력.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#bin>.
+
+- 로컬 프로젝트의 `bin` 디렉토리 경로 출력:
+
+`bun pm bin`
+
+- 전역 `bin` 디렉토리 경로 출력:
+
+`bun pm bin {{[-g|--global]}}`
@@ -0,0 +1,12 @@
+# bun pm cache
+
+> Bun의 캐시를 관맄.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#cache>.
+
+- 전역 모듈 캐시 경로 출력:
+
+`bun pm cache`
+
+- 전역 모듈 캐시 삭제:
+
+`bun pm cache rm`
@@ -0,0 +1,16 @@
+# bun pm hash
+
+> 현재 lockfile의 해시를 생성하고 확인.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#hash>.
+
+- 현재 lockfile의 해시 생성 및 출력:
+
+`bun pm hash`
+
+- lockfile 해시에 사용된 문자열 출력:
+
+`bun pm hash-string`
+
+- 현재 lockfile에 저장된 해시 출력:
+
+`bun pm hash-print`
@@ -0,0 +1,12 @@
+# bun pm ls
+
+> 설치된 의존성과 해당 버전을 나열.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#ls>.
+
+- 현재 프로젝트의 의존성 목록 출력:
+
+`bun pm {{[ls|list]}}`
+
+- 모든 전이적 의존성까지 포함하여 출력:
+
+`bun pm {{[ls|list]}} {{[-a|--all]}}`
@@ -0,0 +1,8 @@
+# bun pm migrate
+
+> 다른 패키지 매니저의 lockfile을 설치 없이 Bun 호환 lockfile로 변환.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#migrate>.
+
+- 현재 프로젝트의 lockfile을 마이그레이션:
+
+`bun pm migrate`
@@ -0,0 +1,32 @@
+# bun pm pack
+
+> npm에 배포될 파일들을 포함한 `.tgz` 아카이브를 생성 (same behavior as `npm pack`).
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#pack>.
+
+- 현재 워크스페이스에서 tarball 생성:
+
+`bun pm pack`
+
+- 실제 디스크에 tarball을 생성하지 않고 모든 단계를 실행 (dry-run):
+
+`bun pm pack --dry-run`
+
+- tarball을 특정 디렉토리에 저장:
+
+`bun pm pack --destination {{경로/대상/디렉토리}}`
+
+- tarball 파일명을 지정:
+
+`bun pm pack --filename {{파일이름}}`
+
+- prepack, postpack, prepare 스크립트 실행 건너뛰기:
+
+`bun pm pack --ignore-scripts`
+
+- gzip 압축 단계 설정 (0-9, 기본: 9):
+
+`bun pm pack --gzip-level 5`
+
+- tarball 파일명만 출력하고 상세 로그 생략:
+
+`bun pm pack --quiet`
@@ -0,0 +1,32 @@
+# bun pm pkg
+
+> `get`, `set`, `delete`, `fix` 작업을 통해 package.json 데이터를 관리.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#pkg>.
+
+- `package.json`의 모든 속성 조회:
+
+`bun pm pkg get`
+
+- 특정 속성 하나 조회:
+
+`bun pm pkg get {{속성}}`
+
+- 여러 속성 조회:
+
+`bun pm pkg get {{속성1 속성2 속성3 ...}}`
+
+- 중첩된 속성 조회:
+
+`bun pm pkg get {{속성}}.{{attribute}}`
+
+- 속성 설정:
+
+`bun pm pkg set {{속성}}="{{값}}"`
+
+- 속성 삭제:
+
+`bun pm pkg delete {{속성}}`
+
+- `package.json`의 일반적인 문제를 자동으로 수정:
+
+`bun pm pkg fix`
@@ -0,0 +1,9 @@
+# bun pm scan
+
+> Bun에 내장된 보안 스캐너를 사용하여 패키지의 보안 취약점을 검사.
+> 이 검사는 `bunfig.toml`에서 스캐너를 설정하고 npm에서 `@bun-security-scanner/osv`를 설치한 이후, `bun install` 실행 시 자동으로 수행됨.
+> 더 많은 정보: <https://bun.com/docs/pm/security-scanner-api>.
+
+- 의존성의 보안 취약점 검사:
+
+`bun pm scan`
@@ -0,0 +1,13 @@
+# bun pm trust
+
+> 의존성을 신뢰된 상태로 표시.
+> 관련 항목: `bun pm untrusted`.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#trust>.
+
+- 특정 의존성을 신뢰로 설정하고 `trustedDependencies`에 추가:
+
+`bun pm trust {{의존성_이름}}`
+
+- 현재 신뢰되지 않은 모든 의존성을 신뢰로 설정:
+
+`bun pm trust --all`
@@ -0,0 +1,20 @@
+# bun pm version
+
+> `package.json`의 `version` 필드를 관리.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm#version>.
+
+- 현재 패키지 버전 출력:
+
+`bun pm version`
+
+- 특정 버전으로 설정:
+
+`bun pm version {{9.0.1}}`
+
+- 시맨틱 버전 규칙(`major`, `minor`, `patch` 등)에 따라 버전 증가:
+
+`bun pm version {{major|minor|patch|premajor|preminor|prepatch|prerelease}}`
+
+- Git 태그를 기준으로 버전 설정:
+
+`bun pm version from-git`
@@ -0,0 +1,37 @@
+# bun pm
+
+> Bun 패키지 매니저와 관련된 유틸리티 모음.
+> `pack`, `pkg`와 같은 일부 하위 명령어는 별도의 사용법 문서를 가짐.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/pm>.
+
+- 현재 워크스페이스를 tarball로 생성:
+
+`bun pm pack`
+
+- `bin` 디렉토리 경로 출력:
+
+`bun pm bin`
+
+- 기본적으로 신뢰된 의존성 목록 출력:
+
+`bun pm default-trusted`
+
+- npm 레지스트리 사용자 이름 출력:
+
+`bun pm whoami`
+
+- 현재 lockfile의 해시 생성 및 출력:
+
+`bun pm hash`
+
+- 스크립트를 포함한 현재 비신뢰 의존성 목록 출력:
+
+`bun pm untrusted`
+
+- 다른 패키지 매니저의 lockfile을 설치 없이 마이그레이션 :
+
+`bun pm migrate`
+
+- `package.json`에서 특정 속성 값 가져오기:
+
+`bun pm pkg get {{프로퍼티}}`
@@ -0,0 +1,36 @@
+# bun publish
+
+> npm 레지스트리에 패키지를 배포.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/publish>.
+
+- 현재 패키지를 npm 레지스트리에 배포:
+
+`bun publish`
+
+- 특정 디렉토리의 패키지 배포:
+
+`bun publish {{경로/대상/패키지_디렉토리}}`
+
+- scopeds 패키지를 특정 접근 권한으로 배포:
+
+`bun publish --access {{public|restricted}}`
+
+- 사용자 지정 레지스트리에 패키지 배포:
+
+`bun publish --registry {{레지스트리}}`
+
+- 실제 업로드 없이 배포 내용을 확인(dry run):
+
+`bun publish --dry-run`
+
+- 특정 distribution 태그로 배포:
+
+`bun publish --tag {{태그_이름}}`
+
+- 2FA 계정을 위한 일회용 비밀번호와 함께 배포:
+
+`bun publish --otp {{one_time_password}}`
+
+- 특정 인증 방식으로 배포:
+
+`bun publish --auth-type {{web|legacy}}`
@@ -0,0 +1,25 @@
+# bun remove
+
+> `package.json`에서 의존성을 제거.
+> 참고: `rm`은 `remove`의 별칭으로 사용할 수 있음.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/remove>.
+
+- 의존성 제거:
+
+`bun remove {{패키지_이름}}`
+
+- 여러 의존성 제거:
+
+`bun remove {{패키지_이름1 패키지_이름2 ...}}`
+
+- 전역으로 설치된 패키지 제거:
+
+`bun remove {{[-g|--global]}} {{패키지_이름}}`
+
+- `package.json` 파일 업데이트 없이 의존성 제거:
+
+`bun remove --no-save {{패키지_이름}}`
+
+- 실제로 제거하지 않고 명령어만 실행 (dry run):
+
+`bun remove --dry-run {{패키지_이름}}`
@@ -0,0 +1,20 @@
+# bun run
+
+> JavaScript/TypeScript 파일을 실행하거나, `package.json`에 정의된 스크립트를 실행.
+> 더 많은 정보: <https://bun.com/docs/runtime>.
+
+- `package.json`에 정의된 스크립트 실행:
+
+`bun run {{스크립트_이름}}`
+
+- JavaScript 또는 TypeScript 파일 직접 실행:
+
+`bun run {{경로/대상/파일.ts}}`
+
+- 파일 변경 시 자동 재시작되는 "watch" 모드로 실행:
+
+`bun run --watch {{경로/대상/파일.ts}}`
+
+- 특정 설정 파일을 사용하여 실행:
+
+`bun run {{[-c|--config]}} {{경로/대상/bunfig.toml}} {{경로/대상/파일.ts}}`
@@ -0,0 +1,21 @@
+# bun test
+
+> Bun의 내장 테스트 러너를 사용하여 테스트를 실행.
+> 빠르고 Jest와 호환되는 테스트 러너로, `*.test.ts` (및 유사한 파일)을 자동으로 탐색.
+> 더 많은 정보: <https://bun.com/docs/test>.
+
+- 프로젝트에서 발견된 모든 테스트 파일 실행:
+
+`bun test`
+
+- 특정 테스트 파일 또는 디렉토리 실행:
+
+`bun test {{경로/대상/파일.test.ts}}`
+
+- 파일 변경 시 자동 재시작되는 "watch" 모드로 실행:
+
+`bun test --watch`
+
+- 테스트 실행 및 코드 커버리지 리포트 생성:
+
+`bun test --coverage`
@@ -0,0 +1,21 @@
+# bun unlink
+
+> 현재 디렉토리를 링크 가능한 패키지로 등록 해제.
+> 관련 항목: `bun link`.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/link#unlinking>.
+
+- 현재 패키지를 전역에서 등록 해제:
+
+`bun unlink`
+
+- 특정 디렉토리의 패키지 등록 해제:
+
+`bun unlink --cwd {{경로/대상/패키지}}`
+
+- 실제로 등록 해제하지 않고 시뮬레이션(dry-run) 실행:
+
+`bun unlink --dry-run`
+
+- 도움말 표시:
+
+`bun unlink {{[-h|--help]}}`
@@ -0,0 +1,32 @@
+# bun update
+
+> Bun 프로젝트의 의존성을 업데이트.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/update>.
+
+- 모든 의존성 업데이트:
+
+`bun update`
+
+- 호환성과 관계없이, 최신 버전으로 업데이트:
+
+`bun update --latest`
+
+- 특정 의존성 업데이트:
+
+`bun update {{패키지_이름}}`
+
+- 특정 버전으로 의존성 업데이트:
+
+`bun update {{패키지_이름}}@{{버전}}`
+
+- 대화형 모드로 의존성 업데이트:
+
+`bun update {{[-i|--interactive]}}`
+
+- 모든 워크스페이스에 대해 재귀적으로 의존성 업데이트:
+
+`bun update {{[-r|--recursive]}}`
+
+- 대화형 및 재귀 모드로 의존성 업데이트:
+
+`bun update {{[-i|--interactive]}} {{[-r|--recursive]}}`
@@ -0,0 +1,16 @@
+# bun upgrade
+
+> Bun을 최신 버전으로 업그레이드.
+> 더 많은 정보: <https://bun.com/docs/installation#upgrading>.
+
+- 최신 안정 버전으로 업그레이드:
+
+`bun upgrade`
+
+- 최신 canary 빌드로 업그레이드:
+
+`bun upgrade --canary`
+
+- 최신 안정 버전으로 다시 전환:
+
+`bun upgrade --stable`
@@ -0,0 +1,24 @@
+# bun why
+
+> 특정 패키지가 왜 설치되었는지 의존성 체인을 통해 설명.
+> 더 많은 정보: <https://bun.com/docs/pm/cli/why>.
+
+- 특정 패키지가 설치된 이유 확인:
+
+`bun why {{패키지_이름}}`
+
+- 패턴에 일치하는 모든 패키지가 설치된 이유 확인:
+
+`bun why "{{패턴}}"`
+
+- 특정 조직의 패키지가 설치된 이유 확인:
+
+`bun why "@{{조직}}/*"`
+
+- 최상위 의존성만 표시:
+
+`bun why {{패키지_이름}} --top`
+
+- 의존성 트리 깊이 제한:
+
+`bun why {{패키지_이름}} --depth {{번호}}`
@@ -0,0 +1,25 @@
+# bunx
+
+> 로컬에 설치되었거나 원격에서 가져온 패키지의 바이너리를 실행.
+> 참고: `bun x`는 `bunx`의 별칭으로 사용할 수 있음.
+> 더 많은 정보: <https://bun.com/docs/pm/bunx>.
+
+- 레지스트리에서 패키지를 다운로드하여 실행:
+
+`bunx {{패키지_이름}} "{{명령어_인수}}"`
+
+- 로컬에 설치된 패키지의 버전 확인 (존재하는 경우):
+
+`bunx {{패키지_이름}} --version`
+
+- 실행파일을 Node 대신 Bun 런타임으로 강제 실행:
+
+`bunx --bun {{패키지_이름}}`
+
+- 패키지 이름과 바이너리 이름이 다른 경우 실행:
+
+`bunx {{[-p|--package]}} {{패키지_이름}} {{명령어}}`
+
+- 특정 버전의 패키지를 다운로드하여 실행:
+
+`bunx {{패키지_이름@버전}} "{{명령어_인수}}"`