监视模式

Bun 支持通过 CLI 标志进行两种自动重新加载

• --watch 模式，在导入的文件发生更改时，硬重启 Bun 的进程。
• --hot 模式，在导入的文件发生更改时，软重新加载代码（不重启进程）。

--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

在观察模式下运行 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,
});