在 Vercel 上部署 Bun 应用程序

Vercel 是一个云平台，让您可以构建、部署和扩展您的应用程序。

Bun 运行时处于 Beta 阶段；某些功能（例如，自动源映射、字节码缓存、node:http/https 的指标）尚未支持。

Bun.serve 目前在 Vercel Functions 中不被支持。请使用 Vercel 支持的框架与 Bun 配合使用，如 Next.js、Express、Hono 或 Nitro。

---

1. 在 vercel.json 中配置 Bun

   要为您的 Functions 启用 Bun 运行时，请在您的 [vercel.json] 文件中添加一个 bunVersion 字段：

   vercel.json

   {
   	"bunVersion": "1.x"
   }
   

   Vercel 会自动检测此配置并在 Bun 上运行您的应用程序。该值必须是 "1.x"，Vercel 在内部处理次要版本。

   为获得最佳效果，请将本地 Bun 版本与 Vercel 使用的版本匹配。

2. Next.js 配置

   如果您正在部署 Next.js 项目（包括 ISR），请更新您的 [package.json]脚本以使用 Bun 运行时：

   package.json

   {
   	"scripts": {
   		"dev": "bun --bun next dev", 
   		"build": "bun --bun next build"
   	}
   }
   

   --bun 标志在 Bun 下运行 Next.js CLI。捆绑（通过 Turbopack 或 Webpack）保持不变，但所有命令都在 Bun 运行时内执行。

   这确保本地开发和构建都使用 Bun。

3. 部署您的应用程序

   将您的仓库连接到 Vercel，或从 CLI 部署：

   terminal

   # 使用 bunx（无需全局安装）
   bunx vercel login
   bunx vercel deploy
   

   或全局安装 Vercel CLI：

   terminal

   bun i -g vercel
   vercel login
   vercel deploy
   

   在 Vercel Deploy CLI 文档中了解更多信息 →

4. 验证运行时

   要确认您的部署使用 Bun，请记录 Bun 版本：

   index.ts

   console.log("runtime", process.versions.bun);
   

   runtime 1.3.3
   

   查看 Vercel Bun 运行时文档了解功能支持 →

---

• Fluid compute: Bun 和 Node.js 运行时都在 Fluid compute 上运行，并支持相同的 Vercel Functions 核心功能。
• Middleware: 要使用 Bun 运行路由中间件，请将运行时设置为 nodejs：

middleware.ts

export const config = { runtime: "nodejs" };