GORM

定义

GORM是一个面向Go语言的对象关系映射库，其设计目标是对开发者友好^[1]。它把数据库表映射为Go的结构体，把表中的列映射为结构体字段，开发者以链式方法调用的方式表达查询，由库内部转换成SQL语句并解析返回结果。GORM属于全功能ORM，内置关联、钩子、预加载、事务、自动迁移等能力，并附带覆盖各功能的测试代码。

它自身不实现数据库协议，而是建立在Go标准库的数据库抽象层之上，通过不同驱动适配具体数据库，因此同一套模型代码可以在多种数据库之间迁移^[3]。官方仓库采用MIT许可证发布，版权声明署名为Jinzhu，起始年份为2013年^[4]。

原理

GORM的核心思路是把SQL语法结构映射为Go的数据结构与调用链。程序启动时通过gorm.Open传入驱动程序与配置对象，得到一个*gorm.DB实例，该实例保存连接池、命名策略、日志器等配置，并被设计为可在多个协程间共享^[5]。

模型映射依赖约定与标签。GORM默认把名为ID的字段当作主键，把结构体名转为下划线的复数形式作为表名，例如User对应users；字段名转下划线后成为列名，例如CreatedAt对应created_at^[6]。开发者可以用结构体标签覆盖这些约定，用primaryKey指定主键、用column指定列名、用type指定数据库类型、用index和uniqueIndex建立索引、用foreignKey声明外键^[7]。嵌入gorm.Model可以一次性获得ID、CreatedAt、UpdatedAt、DeletedAt四个字段^[5]。

查询过程被拆解为一组可组合的方法。Where、Order、Limit、Offset、Select、Omit等方法只是在构建条件，直到调用First、Find、Take、Create、Update、Delete等结尾方法时才真正执行。这些方法可通过$db.Where(cond).Order(col).Limit(n).Find(&rows)$的形式串联^[8]。查询无结果时，First、Last、Take会返回gorm.ErrRecordNotFound，需要用errors.Is判断^[4]。

写入操作默认被包裹在事务中执行，以保证数据一致性，若业务上不需要，可以在初始化时通过SkipDefaultTransaction关闭以提升写入速度^[4]。模型还可以定义钩子方法，在创建、保存、更新、删除、查询的前后插入自定义逻辑，如校验数据、生成编号或写入审计记录。

发展历程

GORM由Jinzhu创建，2013年在GitHub上开源发布，最初的动因是Go语言缺少成熟的ORM库^[7]。早期版本的导入路径为github.com/jinzhu/gorm，其最后发布的版本为v1.9.16^[9]。

由于第2版不再保持向后兼容，项目迁移到go-gorm组织下，导入路径改为gorm.io/gorm。GORM 2.0带来多项结构性调整：不再支持动态表名，创建和删除表需要经由Migrator接口，软删除必须使用gorm.DeletedAt类型，标签名改用驼峰风格，并且默认开启全局更新保护，执行无条件的批量更新或删除需要显式条件或AllowGlobalUpdate选项。

后续版本继续扩展能力，加入了多数据库与读写分离的DB Resolver插件、用于收集指标的Prometheus插件，以及可自定义的命名策略和日志器^[4]。在Go 1.18引入泛型之后，GORM从v1.30.0起提供基于类型参数的泛型API，写法形如gorm.GUser，在编译期约束操作对象类型，同时保持与传统API兼容，两者可以在同一项目中混用^[10]。

应用

GORM用于Go服务的数据库访问层，覆盖单条与批量插入、条件查询、分页排序、聚合计数、关联数据预加载等常见场景^[8]。删除操作在模型嵌入gorm.DeletedAt时默认执行软删除，仅把deleted_at列写为当前时间，查询会自动过滤这些记录，需要物理删除时可使用Unscoped()^[5]。

在结构定义层面，GORM通过标签表达Has One、Has Many、Belongs To、Many To Many以及多态和单表继承等关联。读取关联数据时，Preload会发出额外的查询，Joins则生成连表查询，二者都支持附加过滤条件^[2]。处理大量记录可以使用FindInBatches分批读取，或使用带批次参数的批量插入，避免一次性载入全部数据。

GORM提供AutoMigrate方法，根据模型结构自动建表并补齐缺失的列与索引，已有数据会被保留^[2]。该方法面向开发与持续集成环境，生产环境的表结构变更更适合搭配版本化的迁移工具完成^[5]。

局限

ORM在便利性之外存在固有代价。由框架自动生成的SQL通常不如针对性手写的SQL高效，开发者还需要额外学习框架的调用规则与约定。因此GORM保留了Raw和Exec等方法，允许在必要时直接执行原生SQL语句^[2]。

约定优先的设计也带来一些需要注意的边界。Updates在传入结构体时只更新非零值字段，需要写入零值时必须改用map或配合Select指定字段^[5]。AutoMigrate只做增量调整，不会删除已废弃的列，也用于生产变更时能力有限^[5]。此外，v2为减少内存分配而在链式调用间共享Statement，复用同一个*gorm.DB实例并发执行查询时可能相互影响，需要在新会话之后使用才安全。

参见

• Go语言 —— GORM所依附的编程语言，其并发模型和泛型特性影响了GORM的设计。

• 对象关系映射 —— GORM所属的技术类别，研究程序对象与关系表之间的转换。

• SQL —— GORM方法调用最终生成并执行的目标查询语言。

• MySQL —— GORM通过驱动支持的常见关系型数据库之一。

• PostgreSQL —— GORM通过驱动支持的关系型数据库之一。

• SQLite —— GORM支持的一种嵌入式数据库，官方快速入门示例以其为例。