在 Astro 中使用 Bun
Bun 是一个一体化的 JavaScript 运行时和工具包。更多信息请参阅 Bun 的文档。
将 Bun 与 Astro 结合使用可能会遇到一些问题。某些集成可能无法按预期工作。有关详细信息,请参阅 Bun 关于 Astro 的官方文档。
如果你在使用 Bun 时遇到任何问题,请直接在 Bun 的 GitHub 上提交 Issue。
先决条件
标题为“先决条件”的部分- 在你的本地机器上安装 Bun。请参阅 Bun 官方文档中的安装说明。
使用 Bun 创建一个新的 Astro 项目
标题为“使用 Bun 创建一个新的 Astro 项目”的部分使用以下 create-astro
命令通过 Bun 创建一个新的 Astro 项目
bunx create-astro@latest my-astro-project-using-bun
你也可以使用 --template
标志从任何现有的 Astro GitHub 仓库创建一个新的 Astro 项目
bunx create-astro@latest my-astro-project-using-bun --template eliancodes/brutal
安装依赖
标题为“安装依赖”的部分如果你正在使用 bunx create-astro
启动一个新项目,CLI 将自动使用 Bun 来安装依赖,你可以跳过此步骤。
否则,你需要使用 Bun 安装依赖项
bun install
添加类型
标题为“添加类型”的部分Bun 发布了包含 Bun 运行时类型的 @types/bun
包。
使用以下命令安装 @types/bun
bun add -d @types/bun
使用 Astro 集成
标题为“使用 Astro 集成”的部分你也可以通过 astro add
命令使用任何 Astro 官方集成
bunx astro add react
使用 Bun 运行 Astro
标题为“使用 Bun 运行 Astro”的部分在每个 astro
命令前使用 --bun
CLI 标志,以使用 Bun 自己的运行时替代 Node。
运行开发服务器
标题为“运行开发服务器”的部分要使用 Bun 作为运行时来运行开发服务器,请使用以下命令
bunx --bun astro dev
使用 Bun 构建你的站点
标题为“使用 Bun 构建你的站点”的部分要使用 Bun 作为运行时来构建你的站点,请使用以下命令
bunx --bun astro build
Astro 会将你的站点输出到 dist/
目录。然后,你可以使用 preview
命令来提供你的站点服务
bunx --bun astro preview
使用 Bun 添加 SSR
标题为“使用 Bun 添加 SSR”的部分由于 Bun 具有 Node.js API 兼容性,你可以在你的 Astro 项目中使用任何 Astro 适配器进行按需渲染
bunx astro add vercel
在 Bun 中测试
标题为“在 Bun 中测试”的部分Bun 通过 bun test
命令提供了一个快速、内置、与 Jest 兼容的测试运行器。如果你想使用它,请阅读 bun test
文档。
然而,也可以使用 Cypress 或 Playwright 来对 Web 应用程序进行现代化测试。
Cypress
标题为“Cypress”的部分Cypress 是一个前端测试工具,其使命是“让测试体验变得愉快并为开发者带来快乐”。这使你能够为你的 Astro 站点编写端到端测试。
使用以下命令安装 Cypress
bun add cypress --dev
要完成其余的配置并开始你的第一个测试,请遵循 Astro 测试指南中的 Cypress 流程。
Playwright
标题为“Playwright”的部分Playwright 是一个端到端测试框架,允许你在所有现代渲染引擎(包括 Chromium、WebKit 和 Firefox)上测试你的 Astro 代码。
使用以下命令安装 Playwright
bun create playwright
要创建你的第一个 Playwright 测试,请遵循 Astro 测试指南中 Playwright 流程的其余说明。
官方资源
标题为“官方资源”的部分社区资源
标题为“社区资源”的部分正在使用 Bun 和 Astro 吗?将你的博客文章或视频添加到此页面!
常用方案