什麼是 Bun Shell？

Bun 1.0.24 版本加入的 Bun Shell（即 Bun.$ API）正在改變開發者寫自動化腳本的方式。Bun Shell 是一個跨平台的 shell scripting 解決方案，讓你用 TypeScript/JavaScript 寫出同時能在 macOS、Linux 和 Windows 上跑的腳本，不需要擔心 bash 和 PowerShell 的語法差異。它直接整合在 Bun runtime 裡，不需要額外安裝任何依賴。

為什麼取代 bash 和 Node.js 腳本？

bash 腳本對 JavaScript 開發者來說有很多摩擦點：跨平台相容性問題（Windows 上的 Git Bash 和 WSL 行為不一致）、複雜的字串處理語法、缺乏型別安全、難以測試。用 Node.js 寫腳本也有自己的麻煩：需要 child_process 來執行系統命令，語法冗長；需要手動安裝 shelljs、execa 等套件；啟動時間比 bash 慢。Bun Shell 的優勢：TypeScript 原生支援（不需要 ts-node 或預編譯）、極速啟動（比 Node.js 快 4 倍以上）、跨平台（同一份腳本在 mac、Linux、Windows 都能跑）、內建工具（不需要 npm 安裝 shelljs）、現代 JavaScript 語法全部可用。

安裝與設定

在 macOS 或 Linux 上安裝 Bun：curl -fsSL https://bun.sh/install | bash。Windows 則用 PowerShell 執行 irm bun.sh/install.ps1 | iex。安裝完成後用 bun --version 確認版本是 1.x.x 以上。建立你的第一個 Bun Shell 腳本，在專案根目錄建立 scripts/build.ts，在檔案開頭加上 shebang 並且 import { $ } from bun，就可以開始使用 Bun Shell 了。執行方式：bun run scripts/build.ts，或加上執行權限後直接執行。

Bun.$ 語法基礎

Bun.$ 使用 Tagged Template Literals 語法，跟 shell 命令非常接近。await $ 執行命令；.text() 捕捉文字輸出；.json() 直接解析 JSON 輸出；用 pipe 串接命令。在 template literal 中插入 JS 變數時，Bun Shell 會自動做 shell escaping，避免 shell injection 安全問題。錯誤處理：用 try/catch 捕捉失敗的命令，或用 .nothrow() 讓命令失敗不拋出例外，改為讀取 result.exitCode 判斷成功。

檔案系統操作

Bun 提供了比 Node.js 更簡潔的檔案操作 API：Bun.file(path).text() 讀取文字檔；Bun.write(path, content) 寫入檔案；new Bun.Glob 做 glob 搜尋；Bun.file(path).exists() 檢查檔案是否存在。Bun 的檔案 I/O 比 Node.js 的 fs 模組快很多，對追求建置效率的專案特別有價值，可以搭配 Turbopack 效能指南中的優化思路，打造出極速的開發工作流。

HTTP 請求與 API 呼叫

Bun 內建 fetch API，跟瀏覽器完全相容，不需要安裝 axios 或 node-fetch。基本 GET 請求：const response = await fetch(url)，然後 response.json() 或 response.text() 取得結果。POST 請求傳入 method: POST、headers 和 JSON.stringify(body)。實用場景：在 CI/CD 腳本的尾端，用 fetch 呼叫 Slack Webhook 發送部署通知；或者呼叫 GitHub API 自動建立 Release tag，只需要幾行程式碼，不需要安裝任何套件。

實戰範例

建置腳本：清理 dist 目錄、執行 TypeScript 類型檢查（bun tsc --noEmit）、執行測試（bun test）、打包程式碼（bun build src/index.ts --outdir dist --minify）、複製靜態資源。所有步驟都是 async/await，清晰易讀，比傳統的 npm scripts 更容易維護。資料庫遷移腳本：讀取 migrations 目錄下所有 .sql 檔案，按照檔名排序後依序執行，搭配 Bun.file().text() 讀取 SQL 內容，再傳給 psql 命令執行，整個腳本不需要任何 npm 依賴，啟動速度極快，適合放在 CI pipeline 的 pre-deploy 步驟中。程式碼生成腳本：讀取 OpenAPI spec，解析成物件，自動生成 TypeScript client 程式碼，搭配 Zustand 狀態管理中的模式，在 Bun 腳本中也可以使用輕量的狀態機來管理多步驟任務的進度追蹤。

何時用 Bun Shell vs bash vs Node.js

選擇 Bun Shell 的情況：需要跨平台支援的腳本（開發環境有 Windows 用戶）、需要型別安全的複雜邏輯、需要處理 JSON 或複雜資料結構、Node.js 腳本但想要更快的啟動速度。繼續用 bash 的情況：目標環境只有 Linux/macOS、腳本極度簡單（幾行命令）、需要和現有 bash 腳本深度整合。繼續用 Node.js 的情況：團隊對 Bun 不熟悉、需要某些只有 Node.js 生態有的套件。Bun Shell 在 Next.js PPR 效能優化這類強調建置效率的場景中特別有價值——快速的建置腳本可以讓 CI/CD pipeline 縮短幾分鐘，積累下來是顯著的時間節省。Bun Shell 不是要取代所有腳本工具，而是在「需要 TypeScript 語法的跨平台腳本」這個場景提供了一個比以往更好的解決方案。試試看用 Bun Shell 重寫你現有的 build 或 deploy 腳本，你會發現程式碼更清晰、執行更快，維護起來也更方便。