Drizzle ORM 从入门到精通：下一代 TypeScript ORM 的全面指南

Drizzle ORM 从入门到精通：下一代 TypeScript ORM 的全面指南

引言

在 JavaScript/TypeScript 生态中，ORM 工具一直是开发者的得力助手。传统 ORM 如 Sequelize、TypeORM 提供了丰富的抽象，但往往伴随着学习曲线陡峭、类型推断不完善、运行时性能损耗等问题。近年来，Drizzle 以“无代码生成、类型安全、SQL 风格”的独特设计崭露头角，成为越来越多 TypeScript 项目的首选。

本文将从零开始，循序渐进地带你掌握 Drizzle 的核心概念、常用操作与进阶技巧，帮助你在实际项目中熟练使用这一现代化 ORM。

一、Drizzle 是什么？

Drizzle 是一个专为 TypeScript 设计的轻量级 ORM（对象关系映射）库。它的核心理念是：

• 无代码生成：直接使用 TypeScript 类型系统推导数据库 schema，不依赖额外的代码生成器。
• SQL 友好：API 设计贴合 SQL 语法，让熟悉 SQL 的开发者零成本上手。
• 可预测的性能：生成的 SQL 清晰可控，无隐藏魔法，便于优化和调试。
• 强类型安全：编译期即可发现 SQL 错误，避免运行时才暴露的类型问题。

Drizzle 支持 PostgreSQL、MySQL、SQLite 和 D1（Cloudflare Workers 数据库）等主流数据库，并且提供 ORM 和 Drizzle Kit（迁移工具）两部分，分别负责数据访问和数据库迁移。

二、快速开始

2.1 安装

以 PostgreSQL 为例，先安装依赖：

npm install drizzle-orm pg
npm install -D drizzle-kit @types/pg

如果你的项目使用 SQLite：

npm install drizzle-orm better-sqlite3
npm install -D drizzle-kit @types/better-sqlite3

2.2 定义 Schema

Drizzle 使用 TypeScript 对象定义表结构。创建一个 schema.ts：

import { pgTable, serial, text, timestamp, integer } from 'drizzle-orm/pg-core';

export const users = pgTable('users', {
  id: serial('id').primaryKey(),
  name: text('name').notNull(),
  email: text('email').notNull().unique(),
  age: integer('age'),
  : ().(),
});

   =  users.; 
   =  users.;