跳转到内容
Astro Astro

在 Astro 中使用 Bun

Bun 是一个 all-in-one 的 JavaScript 运行时和工具套件。可请参阅 Bun 的文档 获取更多信息。

前期准备

  • 在你的机器上安装了 Bun。请参阅 Bun 官方文档的 安装说明。

使用 Bun 创建一个新的 Astro 项目

使用以下 create-astro 命令并通过 Bun 创建一个新的 Astro 项目：

Terminal window
bunx create-astro@latest my-astro-project-using-bun

安装依赖

如果你正使用 bunx create-astro 创建一个新的项目，CLI 将会自动使用 Bun 安装依赖，所以你可以跳过这一步。

否则，你需要使用 Bun 安装依赖：

Terminal window
bun install

添加类型

Bun 发布了含有 Bun 的运行时类型的 bun-types 包。

使用以下命令安装 bun-types：

Terminal window
bun add -d bun-types

在 tsconfig.json 文件中将该包添加到你的类型中：

tsconfig.json
  "compilerOptions": {
    "types": ["bun-types"]
  }

使用 Astro 集成

你也可以通过 astro add 命令来使用任意 Astro 官方集成：

Terminal window
bunx astro add react

通过 Bun 运行 Astro

运行开发服务器

为了运行开发服务器并使用 Bun 作为运行时，请使用以下命令：

Terminal window
bunx --bun astro dev

通过 Bun 构建你的站点

为了使用 Bun 作为运行时构建你的站点，请使用以下命令：

Terminal window
bunx --bun astro build

Astro 会将你的站点输出到 dist/ 目录。然后，你可以使用 preview 命令来运行你的站点：

Terminal window
bunx --bun astro preview

通过 @astrojs/node 来让 Bun 添加 SSR

Bun 提供了 Node.js API 兼容性 的功能。使用 @astrojs/node 适配器，你可以通过 Bun 的运行时来替代 Node 来为你的 Astro 项目添加 服务器端渲染。

运行如下命令来为你的 Astro 项目添加 Node.js 适配器：

Terminal window
bunx astro add node

接着，使用和前面相同的构建命令来再次构建你的站点：

Terminal window
bunx --bun astro build

最后，使用如下命令来运行你构建后的站点。

Terminal window
bun ./dist/server/entry.mjs

官方资源

社区资源

已经在 Astro 项目中使用 Bun？请在此页面添加你的博客文章或视频！