在 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 buildAstro 会将你的站点输出到 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 吗?将你的博客文章或视频添加到此页面!
常用方案