使用 Prisma 与 Bun

Prisma 的动态子命令加载需要 npm 与 Bun 一起安装。这会影响 CLI 命令，如 prisma init 和 prisma migrate。生成的代码使用 prisma-client 生成器与 Bun 一起工作。

创建新项目

创建一个目录并使用 bun init 初始化。

terminal

mkdir prisma-app
cd prisma-app
bun init

安装 Prisma 依赖

然后安装 Prisma CLI（prisma）、Prisma Client（@prisma/client）和 LibSQL 适配器作为依赖。

terminal

bun add -d prisma
bun add @prisma/client @prisma/adapter-libsql

使用 SQLite 初始化 Prisma

使用 bunx 运行 Prisma CLI 来初始化模式和迁移目录。本指南使用内存中的 SQLite 数据库。

terminal

bunx --bun prisma init --datasource-provider sqlite

这会创建一个基础模式。打开 prisma/schema.prisma，将 generator 块更新为使用带 bun 运行时的无 Rust 客户端，并添加一个 User 模型。

prisma/schema.prisma

  generator client {
    provider = "prisma-client"
    output = "./generated"
    engineType = "client"
    runtime = "bun"
  }

  datasource db {
    provider = "sqlite"
    url      = env("DATABASE_URL")
  }

  model User { 
    id    Int     @id @default(autoincrement()) 
    email String  @unique
    name  String?
  } 

创建并运行数据库迁移

生成并运行初始迁移。这会将一个 .sql 迁移文件写入 prisma/migrations，创建一个新的 SQLite 数据库，并对其运行迁移。

terminal

 bunx --bun prisma migrate dev --name init

环境变量已从 .env 加载
已从 prisma/schema.prisma 加载 Prisma 模式
数据源 "db"：SQLite 数据库 "dev.db" 位于 "file:./dev.db"

SQLite 数据库 dev.db 已在 file:./dev.db 创建

正在应用迁移 `20251014141233_init`

以下迁移已根据新的模式更改创建并应用：

prisma/migrations/
 └─ 20251014141233_init/
   └─ migration.sql

你的数据库现已与模式同步。

✔ 已生成 Prisma Client (6.17.1) 到 ./generated，用时 18ms

生成 Prisma Client

如输出所示，Prisma 会在你运行新的迁移时重新生成 Prisma client。客户端提供了用于读写数据库的完全类型化 API。你也可以使用 Prisma CLI 手动重新生成。

terminal

bunx --bun prisma generate

使用 LibSQL 初始化 Prisma Client

创建一个新文件 prisma/db.ts，使用 LibSQL 适配器初始化 PrismaClient。

prisma/db.ts

import { PrismaClient } from "./generated/client";
import { PrismaLibSQL } from "@prisma/adapter-libsql";

const adapter = new PrismaLibSQL({ url: process.env.DATABASE_URL || "" });
export const prisma = new PrismaClient({ adapter });

创建测试脚本

编写一个创建新用户并统计数据库中用户数量的脚本。

index.ts

import { prisma } from "./prisma/db";

// 创建新用户
await prisma.user.create({
  data: {
    name: "John Dough",
    email: `john-${Math.random()}@example.com`,
  },
});

// 统计用户数量
const count = await prisma.user.count();
console.log(`数据库中有 ${count} 个用户。`);

运行并测试应用程序

使用 bun run 运行脚本。每次运行都会创建一个新用户。

terminal

bun run index.ts

已创建 john-0.12802932895402364@example.com
数据库中有 1 个用户。

terminal

bun run index.ts

已创建 john-0.8671308799782803@example.com
数据库中有 2 个用户。

terminal

bun run index.ts

已创建 john-0.4465968383115295@example.com
数据库中有 3 个用户。

Prisma 现已与 Bun 一起设置完成。在构建应用时，请参见 Prisma 文档。

使用 PM2 将 Bun 作为守护进程运行

使用 Prisma Postgres 与 Bun

⌘I

概览

部署

运行时与调试

实用工具

生态系统与框架

HTTP 与网络

WebSocket

进程与系统

包管理器

测试运行器

运行时与调试

模块系统

文件系统

实用工具

HTML 处理

二进制数据

流

使用 Prisma 与 Bun