在專案中使用 Bun (實驗性)

你是否也曾為了等待依賴安裝或測試運行而感到焦慮？開發者總是希望開發循環（inner loop）能再快一點，但又擔心引入新的工具會破壞原本穩定的環境。Bun 雖然帶來了極速的體驗，但在一個成熟的專案中，如何與現有的工作流共存往往是個挑戰。

這篇指南將告訴你如何在不改動 pnpm 配置的前提下，嘗試將 Bun 作為你的本地運行環境。

需要準備的東西

• 已安裝 Bun
• Node 22+ (部分腳本仍需使用)
• 專案程式碼庫

快速開始

雖然 Bun 很快，但請注意：目前不建議在 Gateway 運行時（WhatsApp/Telegram）使用 Bun，因為可能存在相容性問題。生產環境請務必使用 Node.js。

1. 安裝依賴

你可以直接使用 Bun 安裝，它會忽略 pnpm-lock.yaml：

bun install

如果你不希望 Bun 產生任何 lockfile，可以加上參數：

bun install --no-save

2. 執行構建與測試

你可以直接用 Bun 來執行 TypeScript 程式碼或跑測試：

bun run build
bun run vitest run

疑難排解

生命週期腳本被攔截

Bun 預設可能會攔截依賴包的生命週期腳本（lifecycle scripts）。在這個專案中，通常被攔截的腳本其實不影響運行：

• @whiskeysockets/baileys 的 preinstall：檢查 Node 版本（我們已使用 Node 22+，所以沒問題）。
• protobufjs 的 postinstall：僅輸出版本警告。

如果你在運行時遇到因為缺少這些腳本導致的問題，可以手動信任它們：

bun pm trust @whiskeysockets/baileys protobufjs

部分指令無法執行

有些腳本目前仍寫死了 pnpm（例如 docs:build, ui:*, protocol:check）。如果你遇到這類指令報錯，請暫時切換回 pnpm 執行。

下一步

• 專案架構說明
• 部署至生產環境

如果你在設定過程中遇到任何困難，可以詢問 AI Setup Assistant 獲取即時協助。