当前位置：首页 > news >正文

Drizzle ORM 全面介绍

news 2026/5/12 2:37:55

Drizzle ORM 是一款专为 TypeScript/JavaScript 生态打造的轻量级、类型安全的对象关系映射（ORM）工具，核心定位是兼顾「原生 SQL 的灵活性」与「ORM 开发的便捷性」，成为现代数据库开发的热门选择，尤其受全栈、后端开发者青睐。

一、核心特性

极致的类型安全基于 TypeScript 构建，从数据库 schema 定义到查询、更新操作，全程提供精准的类型推导，无需手动写类型声明，能在编译阶段拦截绝大多数数据库操作错误（比如字段名写错、类型不匹配），大幅降低线上 Bug 率。举例：查询不存在的字段时，编辑器会直接报错，而非运行时才暴露问题。
贴近原生 SQL，不封装过度不同于部分 ORM 屏蔽原生 SQL、强制开发者用抽象语法，Drizzle ORM 以「SQL 优先」为理念：
- 支持直接编写原生 SQL 片段，也能通过链式 API 构建查询（两种方式可混合使用）；
- 生成的 SQL 语句简洁、可预测，无冗余嵌套，方便调试和性能优化。
轻量化 & 无冗余依赖核心包体积小，无重型依赖，启动和运行效率接近原生数据库驱动，适合对性能敏感的场景（比如服务端渲染、微服务）。
多数据库兼容原生支持主流关系型数据库：PostgreSQL（含 Neon、Supabase）、MySQL/MariaDB、SQLite（含 Cloudflare D1、Turso），且适配各数据库的原生特性（如 Postgres 的 JSONB 类型、MySQL 的地理空间函数）。
Schema 即代码，支持迁移通过 TypeScript 代码定义数据库表结构（Schema），替代传统的 SQL 迁移文件，且内置迁移工具 drizzle-kit，能自动生成、执行数据库迁移脚本，适配开发→测试→生产的全流程。

二、适用人群 & 场景

全栈 / 后端开发者：用 TypeScript 开发 Node.js 服务，需要类型安全的数据库操作，同时不想放弃原生 SQL 的灵活性；
创业项目 / 小团队：追求开发效率，无需复杂配置即可快速上手，且后期易维护；
对性能有要求的场景：拒绝过度封装带来的性能损耗，需要精准控制 SQL 执行逻辑；
多数据库适配需求：一套代码兼容 Postgres/MySQL/SQLite，降低跨数据库迁移成本。

三、与主流 ORM 的核心差异

特性	Drizzle ORM	Prisma（主流 ORM）	TypeORM
类型安全	运行时 + 编译时双保障	编译时为主	需手动补充类型，不够精准
SQL 控制度	高（贴近原生）	低（抽象化）	中等（封装较深）
体积 / 性能	轻量、高性能	中等	较重，性能一般
迁移方式	Schema 代码生成迁移	基于 Prisma Schema 文件	支持多种迁移方式，较复杂

四、入门门槛 & 生态

学习成本：因贴近 SQL，有基础 SQL 知识的开发者能快速上手，API 设计直观，文档清晰；
生态配套：官方提供 CLI 工具（drizzle-kit）、与 Next.js/Nest.js 等框架的集成方案，社区插件丰富（如分页、软删除）；
开源属性：完全开源（MIT 协议），无商业版限制，维护活跃。

五、简单示例（核心用法）

typescript
 
运行
 
// 1. 定义 Schema（表结构）
import { pgTable, varchar, integer } from 'drizzle-orm/pg-core';const users = pgTable('users', {id: integer('id').primaryKey(),name: varchar('name', { length: 50 }).notNull(),email: varchar('email', { length: 100 }).unique().notNull(),
});// 2. 连接数据库并查询
import { drizzle } from 'drizzle-orm/postgres-js';
import postgres from 'postgres';const client = postgres('postgres://user:password@localhost:5432/db');
const db = drizzle(client);// 类型安全的查询：返回的 user 自动推导类型
const user = await db.select().from(users).where(users.id.eq(1));