Skip to content

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

NOTE

`Bun.serve` 目前在 Vercel Functions 上不受支持。请使用 Vercel 支持的框架与 Bun 一起使用,如 Next.js、Express、Hono 或 Nitro。

在 vercel.json 中配置 Bun

要为你的 Functions 启用 Bun 运行时,在你的 vercel.json 文件中添加一个 bunVersion 字段:

json
{
	"bunVersion": "1.x"
}

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

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

Next.js 配置

如果你正在部署 Next.js 项目(包括 ISR),请更新你的 package.json 脚本以使用 Bun 运行时:

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

NOTE

`--bun` 标志在 Bun 下运行 Next.js CLI。打包(通过 Turbopack 或 Webpack)保持不变,但所有命令都在 Bun 运行时内执行。

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

部署你的应用程序

将你的仓库连接到 Vercel,或从 CLI 部署:

bash
# 使用 bunx(无需全局安装)
bunx vercel login
bunx vercel deploy

或者全局安装 Vercel CLI:

bash
bun i -g vercel
vercel login
vercel deploy

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

验证运行时

要确认你的部署使用 Bun,记录 Bun 版本:

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

在 Vercel Bun Runtime 文档中查看功能支持情况 →


  • Fluid compute:Bun 和 Node.js 运行时都在 Fluid compute 上运行,并支持相同的核心 Vercel Functions 功能。
  • Middleware:要在 Bun 下运行 Routing Middleware,请将运行时设置为 nodejs
ts
export const config = { runtime: "nodejs" }; 

Bun学习网由www.bunjs.com.cn整理维护