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