用途:为不同数据库提供 Prisma ORM 配置指南,适用于初始化新项目、切换数据库提供方、配置连接串与环境变量、排查连接问题、设置数据库特性以及生成和实例化 Prisma Client。
主要能力:按优先级组织规则,包括提供方指南(关键)、Prisma Postgres(高)、客户端设置(关键)。支持 PostgreSQL(默认,功能完整)、MySQL、SQLite(本地文件,无枚举/标量列表)、MongoDB(Mongo 专属流程,不适用 SQL 驱动适配器指南)、SQL Server、CockroachDB 以及托管的 Prisma Postgres。
使用方式:所有提供方使用 prisma/schema.prisma;Prisma 7 的 SQL 配置通常用 prisma.config.ts 存放数据源 URL;MongoDB 项目应停留在 Prisma 6.x,在 schema 中保留 url = env("DATABASE_URL"),不要套用 Prisma 7 SQL 适配器流程。SQL 工作流使用驱动适配器并传给 PrismaClient,例如 PostgreSQL 用 @prisma/adapter-pg 与 pg。需安装 Prisma CLI 与 Prisma Client:npm install prisma --save-dev、npm install @prisma/client;添加 generator 块(prisma-client 需显式 output 路径),运行 npx prisma generate,每次 schema 变更后重新生成。使用 Bun 时以 bunx --bun prisma ... 运行 CLI。
适用场景:新项目初始化、数据库迁移切换、连接配置与故障排查、客户端生成与适配器接入。
限制:系统要求 Node.js 20.19.0+、TypeScript 5.4.0+;MongoDB 不应安装 SQL @prisma/adapter-* 包,也不应迁移到 Prisma 7 SQL 适配器配置。详细步骤见 references 下各提供方与 prisma-client-setup 规则文件。