prisma：下一代 Node.js 与 TypeScript ORM 框架

摘要

Prisma 是一个专为 Node.js 和 TypeScript 设计的下一代开源 ORM 框架，提供极致类型安全的数据库访问、声明式迁移以及可视化的数据管理能力。

开源与热度：基于 Apache 2.0 协议开源，在 GitHub 上拥有 45377 颗 Stars。
三大核心工具：包含 Prisma Client（自动生成的类型安全查询构建器）、Prisma Migrate（声明式数据建模与迁移系统）和 Prisma Studio（可视化数据库 GUI）。
统一的 Schema 管理：通过单一的 .prisma 文件统一配置数据源、生成器和数据模型，并支持通过“数据内省”从现有数据库反向生成模型。
极致的类型安全：在 TypeScript 环境下提供静态类型检查，可在编译阶段捕获拼写错误，且查询结果直接返回纯 JavaScript 对象，无需处理复杂的 ORM 实例。
广泛的数据库支持：支持 PostgreSQL、MySQL、SQLite、SQL Server、MongoDB 以及 CockroachDB。
架构兼容性：兼容 Serverless 应用与微服务架构，适用于构建 REST、GraphQL、gRPC 等多种 API 服务。
代码生成机制：每次修改数据模型后，需通过 npx prisma generate 命令重新生成客户端代码，以确保 API 与数据库结构同步。

环境变量加载限制：当使用 prisma.config.ts 配置文件时，Prisma 不会自动加载 .env 文件，开发者必须手动引入 dotenv 包或依赖运行环境（如 Node.js 的 --env-file）来加载环境变量。
版本依赖要求：自 Prisma 7 版本起，实例化 Prisma Client 时强制要求必须配合使用数据库驱动适配器（Driver Adapter）。

Prisma 是一个专为 Node.js 和 TypeScript 后端应用设计的“下一代 ORM”工具集。它通过直观的数据建模语言和自动生成的客户端，为开发者提供类型安全的数据库访问、声明式的数据库迁移以及可视化的数据管理能力。

极致的类型安全：在 TypeScript 环境下，查询结果会被静态类型化，能够防止访问不存在的属性，并在编译阶段捕获拼写错误（即使只查询模型的部分字段也能保持类型安全）。
统一的 Schema 定义：所有项目均从一个 .prisma 文件开始，开发者在其中统一配置数据源、生成器并定义应用的数据模型。
返回原生对象：Prisma Client 的所有查询结果均返回纯 JavaScript 对象（Plain old JavaScript objects），无需处理复杂的 ORM 实例。
多数据库支持：支持 PostgreSQL、MySQL、SQLite、SQL Server、MongoDB 以及 CockroachDB 等主流数据库。

安装依赖：将 Prisma CLI 安装为开发依赖，并安装 @prisma/client。
编写 Schema：在 Prisma schema 文件中定义数据源（如指定数据库类型）和生成器（指定输出路径）。
配置连接：通过 prisma.config.ts 文件或环境变量配置数据库连接字符串。
生成客户端：运行 npx prisma generate 命令，Prisma 会读取 Schema 并自动生成客户端代码。每次修改数据模型后都需要重新执行此命令。
实例化与查询：在代码中引入生成的 PrismaClient 并实例化，随后即可调用 API 进行 CRUD 操作。

环境变量加载：当使用 prisma.config.ts 时，Prisma ORM 不会自动加载 .env 文件中的环境变量。开发者需要手动引入 dotenv 等第三方包，或依赖运行环境（如 Bun、Node.js 的 --env-file 参数）来加载。
驱动适配器要求：自 Prisma 7 版本起，实例化 Prisma Client 时必须配合使用数据库驱动适配器（Driver Adapter）。