# macOS / Linux / WSL（推薦）
curl -fsSL https://bun.sh/install | bash

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

# 用 npm 安裝（如果你已經有 Node.js）
npm install -g bun

# macOS 用 Homebrew
brew install oven-sh/bun/bun

# Windows 用 Scoop
scoop install bun
Code language: PHP (php)

bun --version
# 輸出類似：1.2.x 或 1.3.x
Code language: CSS (css)

sudo apt install unzip  # Ubuntu/Debian
Code language: PHP (php)

// hello.js
console.log("Hello from Bun!");
Code language: JavaScript (javascript)

bun run hello.js
# 輸出：Hello from Bun!

# 或者省略 run
bun hello.js
Code language: CSS (css)

// greet.ts
const name: string = "Vibe Coder";
const age: number = 2025;
console.log(`Hello ${name}, welcome to ${age}!`);
Code language: JavaScript (javascript)

bun greet.ts
# 輸出：Hello Vibe Coder, welcome to 2025!
Code language: CSS (css)

# Node.js 傳統流程（麻煩）
npx tsc greet.ts        # 先編譯成 .js
node greet.js           # 再執行 .js

# Bun 流程（一步到位）
bun greet.ts            # 直接執行
Code language: CSS (css)

bun --watch greet.ts
Code language: CSS (css)

{
  "scripts": {
    "dev": "bun --watch src/index.ts",
    "build": "bun build src/index.ts --outdir dist",
    "test": "bun test"
  }
}
Code language: JSON / JSON with Comments (json)

bun run dev    # 執行 dev script
bun dev        # 簡寫，省略 run
Code language: PHP (php)

# 安裝 package.json 中所有依賴
bun install

# 簡寫
bun i
Code language: PHP (php)

┌─────────────────────────────────────────────────┐
│  npm/yarn/pnpm 的做法                            │
│  1. 解析 package.json                            │
│  2. 查詢 registry 取得版本資訊                    │
│  3. 下載每個套件的 tarball                        │
│  4. 解壓縮                                       │
│  5. 寫入 node_modules                            │
└─────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────┐
│  Bun 的做法                                      │
│  1. 全域快取：下載過的套件不再重複下載             │
│  2. 用 Zig 寫的：比 JavaScript 快很多             │
│  3. 平行處理：同時處理多個套件                     │
│  4. 硬連結：不複製檔案，用連結節省 I/O             │
└─────────────────────────────────────────────────┘

# 新增一般依賴
bun add express

# 新增開發依賴（-d 或 --dev）
bun add -d typescript

# 新增指定版本
bun add react@18.2.0

# 新增最新版本
bun add lodash@latest
Code language: PHP (php)

# 安裝精確版本（不加 ^ 符號）
bun add express --exact
# package.json 會寫 "express": "4.18.2" 而不是 "^4.18.2"

# 新增為 peer dependency
bun add react --peer

# 新增為 optional dependency
bun add canvas --optional
Code language: CSS (css)

# 移除套件
bun remove express

# 簡寫
bun rm express
Code language: PHP (php)

// bun.lock（簡化範例）
{
  "lockfileVersion": 1,
  "packages": {
    "express": ["[email protected]", {
      "dependencies": {
        "body-parser": "1.20.1",
        "cookie": "0.5.0"
      }
    }]
  }
}
Code language: JSON / JSON with Comments (json)

# 根據 lockfile 安裝（CI/CD 必用）
bun install --frozen-lockfile

# 或用 bun ci（等同上面指令）
bun ci

# 只更新 lockfile，不實際安裝
bun install --lockfile-only

# 從舊的 bun.lockb 遷移到新的 bun.lock
bun install --save-text-lockfile
Code language: PHP (php)

# .gitignore 不應該包含這些
# bun.lock      # 不要忽略！
# bun.lockb     # 不要忽略！
Code language: CSS (css)

# 現有 npm 專案可以直接用 Bun
cd my-npm-project
bun install          # 讀取 package.json，建立 bun.lock
bun run dev          # 執行 scripts
Code language: PHP (php)

# 團隊統一用 Bun 時，可以刪除舊的 lockfile
rm package-lock.json yarn.lock pnpm-lock.yaml
bun install
git add bun.lock
Code language: CSS (css)

# AI 可能會寫 npm install，你可以改成：
bun add <套件名>

# 看到這個就知道在安裝開發依賴
bun add -d <套件名>
Code language: HTML, XML (xml)

# AI 可能會寫 npx tsx script.ts，你可以直接：
bun script.ts

# 看到 package.json 的 scripts，直接：
bun run <script名稱>
Code language: CSS (css)

bun.lock     → Bun 1.2+ 的文字鎖定檔（推薦）
bun.lockb    → Bun 舊版的二進位鎖定檔
Code language: CSS (css)