Watch 模式

Bun 透過 CLI 旗標支援兩種自動重新載入模式

• --watch 模式，會在匯入的檔案變更時硬重新啟動 Bun 的程序。
• --hot 模式，會在匯入的檔案變更時軟重新載入程式碼 (不會重新啟動程序)。

--watch 模式

Watch 模式可以搭配 bun test 使用，或在執行 TypeScript、JSX 和 JavaScript 檔案時使用。

若要以 --watch 模式執行檔案

bun --watch index.tsx

若要以 --watch 模式執行您的測試

bun --watch test

在 --watch 模式下，Bun 會追蹤所有匯入的檔案，並監看它們的變更。當偵測到變更時，Bun 會重新啟動程序，保留初始執行時使用的相同 CLI 引數和環境變數。如果 Bun 崩潰，--watch 將嘗試自動重新啟動程序。

以下範例顯示 Bun 在檔案編輯時即時重新載入檔案，VSCode 設定為在每次按鍵時儲存檔案。

bun run --watch watchy.tsx

import { serve } from "bun";
console.log("I restarted at:", Date.now());

serve({
  port: 4003,

  fetch(request) {
    return new Response("Sup");
  },
});

在此範例中，Bun 正在

以 watch 模式執行 bun test，並啟用 save-on-keypress

bun --watch test

--hot 模式

使用 bun --hot 在使用 Bun 執行程式碼時啟用熱重新載入。這與 --watch 模式不同，因為 Bun 不會硬重新啟動整個程序。相反地，它會偵測程式碼變更，並使用新的程式碼更新其內部模組快取。

注意 — 這與瀏覽器中的熱重新載入不同！許多框架提供「熱重新載入」體驗，您可以編輯並儲存您的前端程式碼（例如，React 元件），並在瀏覽器中看到變更反映出來，而無需重新整理頁面。Bun 的 --hot 是這種體驗的伺服器端對應功能。若要在瀏覽器中取得熱重新載入，請使用像 Vite 這樣的框架。

bun --hot server.ts

從進入點（在上述範例中為 server.ts）開始，Bun 會建立所有匯入的原始碼檔案（排除 node_modules 中的檔案）的註冊表，並監看它們的變更。當偵測到變更時，Bun 會執行「軟重新載入」。所有檔案都會重新評估，但所有全域狀態（特別是 globalThis 物件）都會被保留。

// make TypeScript happy
declare global {
  var count: number;
}

globalThis.count ??= 0;
console.log(`Reloaded ${globalThis.count} times`);
globalThis.count++;

// prevent `bun run` from exiting
setInterval(function () {}, 1000000);

如果您使用 bun --hot server.ts 執行此檔案，您會看到每次儲存檔案時，重新載入計數都會遞增。

bun --hot index.ts

Reloaded 1 times
Reloaded 2 times
Reloaded 3 times

傳統的檔案監看器（如 nodemon）會重新啟動整個程序，因此 HTTP 伺服器和其他有狀態物件會遺失。相對地，bun --hot 能夠反映更新後的程式碼，而無需重新啟動程序。

HTTP 伺服器

這使得例如更新您的 HTTP 請求處理常式成為可能，而無需關閉伺服器本身。當您儲存檔案時，您的 HTTP 伺服器將會重新載入更新後的程式碼，而無需重新啟動程序。這帶來極快的重新整理速度。

globalThis.count ??= 0;
globalThis.count++;

Bun.serve({
  fetch(req: Request) {
    return new Response(`Reloaded ${globalThis.count} times`);
  },
  port: 3000,
});