TypeORM入门介绍

一、TypeORM 定义

TypeORM 是一款基于 TypeScript/JavaScript 的 ORM（对象关系映射）框架，专为 Node.js 设计，支持多种数据库（MySQL、PostgreSQL、SQLite 等），能够将数据库中的表结构映射为 TypeScript/JavaScript 类，让开发者以面向对象的方式操作数据库，无需直接编写复杂的 SQL 语句。

二、核心优势

1. TypeScript 原生支持：完全基于 TypeScript 开发，提供强类型校验，降低代码出错率，提升开发体验；
2. 跨数据库兼容：适配主流关系型数据库，甚至支持 MongoDB 等 NoSQL 数据库，切换数据库成本低；
3. 丰富的功能集：内置实体、关系映射、迁移、事务、查询构建器等核心能力，覆盖开发全流程；
4. 框架集成友好：无缝对接 NestJS、Express、Koa 等主流 Node.js 框架；
5. 符合最佳实践：支持 Active Record 和 Data Mapper 两种设计模式，满足不同开发习惯；
6. 自动化程度高：支持自动同步实体到数据库表结构，简化开发初期的表结构管理。

三、适用场景

• 中小型 Node.js 后端项目，快速开发数据库相关功能；
• 基于 TypeScript 的企业级应用，追求强类型和代码可维护性；
• 需要跨数据库部署的项目，降低数据库适配成本；
• 与 NestJS 深度集成的项目（NestJS 官方推荐 ORM）；
• 追求开发效率，希望减少原生 SQL 编写的场景。

四、与其他 ORM 对比

ORM 框架	核心特点	优势	劣势
TypeORM	TypeScript 原生、功能全面、框架集成友好	强类型、适配多框架/数据库、迁移能力完善	部分高级查询性能略低、学习曲线稍陡
Sequelize	老牌 Node.js ORM、社区成熟	文档丰富、生态完善、上手简单	TypeScript 支持为后加、部分 API 不够优雅
Prisma	新一代 ORM、Schema 优先、自动生成客户端	查询性能优、类型提示极致、零配置迁移	灵活性略低、对复杂关系支持不如 TypeORM

五、核心概念快速扫盲

1. 实体（Entity）：映射数据库表的 TypeScript 类，每个实体实例对应表中的一行数据；
2. 仓库（Repository）：操作实体的核心对象，提供 CRUD 等数据库操作方法；
3. 迁移（Migrations）：管理数据库表结构变更的文件，保证多环境表结构一致；
4. 关系（Relations）：描述实体之间的关联（一对一、一对多、多对多等），对应数据库外键关系；
5. 查询构建器（QueryBuilder）：链式调用的方式构建复杂 SQL，兼顾灵活性和可读性。

六、环境依赖

1. Node.js 版本：推荐 v14.0.0 及以上，TypeORM 部分新特性依赖高版本 Node.js 特性；
2. TypeScript 配置要求：
   • 启用 experimentalDecorators 和 emitDecoratorMetadata（装饰器支持）；
   • 目标版本建议 ES2018 及以上；
   • 模块系统推荐 CommonJS（Node.js 环境）或 ESModules（需配合适配配置）。

至此，本章节的学习就到此结束了，如有疑惑，可对接技术客服进行相关咨询。