在 Vercel 上部署 Bun 应用

Vercel 是一个云平台，允许你构建、部署和扩展你的应用。

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

Bun.serve 当前不支持在 Vercel Functions 上使用。请在 Vercel 支持的框架中使用 Bun，如 Next.js、 Express、Hono 或 Nitro。

在 vercel.json 中配置 Bun

要启用 Bun 运行时以支持你的 Functions，在 vercel.json 文件中添加 bunVersion 字段：

vercel.json

{
	"bunVersion": "1.x"
}

Vercel 会自动检测此配置，并在 Bun 上运行你的应用。该值必须是 "1.x"，Vercel 会内部管理具体的次要版本号。为了达到最佳效果，请确保你的本地 Bun 版本与 Vercel 使用的版本相匹配。

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。

部署你的应用

将你的代码库连接至 Vercel，或通过 CLI 进行部署：

terminal

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

或者全局安装 Vercel CLI：

terminal

bun i -g vercel
vercel login
vercel deploy

验证运行时

要确认你的部署使用了 Bun，可以打印 Bun 版本：

index.ts

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

runtime 1.3.3

middleware.ts

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