Go mod 好菜系列 - 0x02 Gorm 这盘 ORM 到底怎么吃

详细拆 gorm 的定位、模型定义、迁移、CRUD、查询链、关联和事务,看看它为什么常见、又为什么经常引发争议。

只要一聊 Go 数据库生态,gorm 基本很难绕过去。有人觉得它真香,能省掉一大堆 SQL 模板劳动;也有人嫌它太重、太黑盒、容易把查询性能搞成谜语。两边都不算完全错,关键在于你得先知道它是个什么东西。

gorm 是干嘛的

它是一个 ORM。简单说,就是把数据库表和 Go 结构体做了一层映射,让你能更多地用 Go 代码操作数据,而不是每次都从零手写 SQL。

它最典型能帮你做的事包括:

  • 模型定义
  • CRUD
  • 条件查询
  • 关联关系
  • 自动迁移
  • 事务

为什么 gorm 常见

因为很多业务项目都有类似需求:表不少、模型多、增删改查重复劳动多。如果你全手写 SQL,当然更可控,但也确实更容易累。gorm 刚好填了这个“开发效率优先”的位置。

一个最基础的模型

type User struct {
    ID        uint           `gorm:"primaryKey"`
    Name      string         `gorm:"size:64;not null"`
    Email     string         `gorm:"uniqueIndex"`
    CreatedAt time.Time
    UpdatedAt time.Time
}

gorm 默认会根据结构体推表名、推字段,也会自动识别一些常见约定,比如主键、时间字段。

连接数据库

dsn := "user:password@tcp(127.0.0.1:3306)/demo?charset=utf8mb4&parseTime=True&loc=Local"
db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
if err != nil {
    return err
}

如果你前面学过 database/sql,这里可以把 gorm 理解成“站在它上面的一层更高抽象”。底层很多事还是那套数据库驱动和连接池逻辑。

自动迁移很好用,但别无脑全信

err := db.AutoMigrate(&User{})
if err != nil {
    return err
}

这一步在开发环境里非常顺手,改个字段就能快速把表结构推过去。但到了正式环境,涉及大表变更、索引调整、数据迁移的时候,别把 AutoMigrate 当神仙按钮。复杂变更还是建议显式管理。

CRUD 写法为什么让人上头

user := User{Name: "Raymond", Email: "ray@example.com"}
if err := db.Create(&user).Error; err != nil {
    return err
}

var result User
if err := db.First(&result, 1).Error; err != nil {
    return err
}

if err := db.Model(&result).Update("name", "Ray").Error; err != nil {
    return err
}

if err := db.Delete(&result).Error; err != nil {
    return err
}

这类写法的优点非常直观:模型感强,样板少,读起来像“我要干什么”,而不是“我要拼哪句 SQL”。

查询链是 gorm 的日常主战场

var users []User
err := db.Where("age > ?", 18).
    Order("created_at desc").
    Limit(20).
    Find(&users).Error

这也是 gorm 让人觉得“效率高”的关键之一。它把很多条件组合写成了链式风格,适合日常业务查询。

关联关系也常见

type User struct {
    ID    uint
    Name  string
    Posts []Post
}

type Post struct {
    ID     uint
    Title  string
    UserID uint
}
var user User
err := db.Preload("Posts").First(&user, 1).Error

Preload 很好用,但也很容易让人不知不觉查出一大堆数据。关联一多,链路一深,性能就开始变玄学。所以能方便,不代表能放飞。

事务也照样能写

err := db.Transaction(func(tx *gorm.DB) error {
    if err := tx.Create(&User{Name: "A"}).Error; err != nil {
        return err
    }
    if err := tx.Create(&User{Name: "B"}).Error; err != nil {
        return err
    }
    return nil
})

这个 API 用起来很顺,而且可读性不错。对很多业务场景来说,这层封装是加分的。

gorm 最常被吐槽什么

  • 生成 SQL 不够透明
  • 复杂查询写着写着还是得掉回原生 SQL
  • 关联多了以后很容易搞出性能问题
  • 团队成员如果不懂底层 SQL,容易“会用但不知后果”

所以 gorm 的正确使用姿势从来不是“我再也不用懂 SQL 了”,而是“我用它提高常规开发效率,但底层 SQL 依然得懂”。

什么时候适合用 gorm

  • 中小型业务系统
  • CRUD 很多、模型很稳的场景
  • 想提高研发效率
  • 团队能接受 ORM 约定

如果你做的是极度复杂、极度性能敏感的查询服务,那 gorm 未必是最优解,甚至你可能最后会混用原生 SQL。

小结

gorm 是一盘很常见的菜,但吃法得对:

  • 它能明显提高常规数据层开发效率
  • 模型、查询链、关联、迁移都很顺手
  • 方便不等于可以不懂 SQL
  • 复杂查询和性能敏感场景别闭眼全靠 ORM

下一篇我们换一道偏基础设施的菜:go-redis。数据库写慢了以后,很多项目下一步都会想碰它。

Read more

序章:长夜之后

后来的历史书把那一天称为“长夜之后”。 这个名字并不准确。事情发生在地球上的许多个白天和夜晚之间,发生在不同经度的清晨、午后、傍晚,发生在地下库房、山体掩体、海军基地、荒原试验场和无人值守的材料贮存井里。它既不是一场战争,也不是一次统一指挥的袭击。没有人按下那个能够解释一切的按钮。 但历史需要一个名称。 “长夜之后”最终被保留下来,是因为调查者在追溯事件源头时,不得不一次又一次回到海王星。回到那颗距离太阳太远、光照近乎吝啬的蓝色行星。回到六名中国宇航员死去的地方。回到一艘核动力科考船熄灭后的漫长黑暗。 在联合调查委员会公开的第一版报告中,事件时间线被压缩成了一页表格。 2030年9月,问海一号在海王星附近失联。 2034年11月,问海二号抵达失事区域,确认问海一号全员死亡。 2035年1月,问海二号完成样本封装,开始返航。 2038年6月,海王星样本进入地球高等级隔离实验室。 2038年7月,全球多个核材料设施发生不可逆事故,部分核电站进入最高级别应急。 2038年8月,所有已知核武库事实上失效,全球核电装机大规模停运。 这张表格后来被反复引用,因为它足够冷静,也

By Fuyu Jia

第一章:四小时以前的地球

林予舟第一次听见“问海一号”的最后通信,是在距离地面三百九十公里的轨道上。 那不是一个适合听遗言的地方。 舷窗外,地球从飞船腹侧缓慢转过去,云层像被谁铺平的白色金属屑,青藏高原的阴影压在晨昏线上。太阳还没有完全越出地平线,近地轨道的黑暗因此显得很薄,像一层马上要被擦掉的墨。 “链路稳定。”林予舟说。 他的声音被舱内麦克风收进去,压缩,打包,送进中继卫星,再落回海南深空任务中心。延迟不到一秒。这样奢侈的实时感,在他们离开地月系统后会迅速消失。等飞船抵达海王星附近,地球说一句话,要四个小时左右才能抵达;他们回一句,地球也要再等四个小时。 对话会变成考古。 控制台上方的状态灯一排排亮着,绿色多得几乎让人不安。问海二号还在近地轨道泊位上,推进舱、居住舱、通信桁架和补给舱刚完成最后一次组合检查。它不像公众宣传片里那样优雅。现实中的深空飞船更像一串被迫相互妥协的工程物:银灰色隔热层、外露管线、姿控喷口、展开到一半的高增益天线,所有东西都为了质量、功耗、散热和冗余让步。 它也不像一艘该去海王星的船。 至少不像一艘该去救援核动力深空飞船的船。 问海二号没有主反应堆。 这件事在公开报

By Fuyu Jia

第二章:没有核反应堆的船

发射前四十分钟,林予舟收到了一条来自地面的私人通信。 通信被压在任务数据包后面,标记为低优先级。它随着推进剂温度曲线、姿态平台校准结果、医学监测基线和最后一版逃逸窗口修正量一起进入问海二号的主机,像一枚被夹在工具箱里的薄纸片。 林予舟本来不该在这个时候打开它。 发射前四十分钟,人的每一个动作都应当有明确目的。检查阀门状态,确认加压序列,复诵逃逸程序,核对地面口令。人的情绪如果在这个时候出现,就应该被折叠起来,放进某个不影响任务的地方。 他还是点开了。 画面里是母亲的厨房。抽油烟机没有开,镜头被热气熏得微微发白。桌上摆着一碗面,青菜、荷包蛋和切得很薄的牛肉。母亲没有出镜,只在画面外说:“我知道你现在不能吃,等回来再吃也一样。” 林予舟看着那碗面,隔了几秒才意识到自己没有呼吸。 “怎么了?”沈从越问。 “私人包。” “家里?” “嗯。” “看完删掉。”沈从越说,“别让它留在主屏缓存里。发射时系统会重排任务窗口,乱七八糟的东西越少越好。” 他语气平淡,不像关心,也不像责备。沈从越说话常常这样,像把所有情绪都预先压成了流程。林予舟关掉视频,把它转存进私人存储区。那碗面从

By Fuyu Jia

第三章:地球变成录音

离开地月系统后的第十九天,林予舟第一次觉得,地球不是一个地方,而是一种延迟。 最初的几天,通信仍然近乎实时。地面问,他们答;他们报数,地面确认。贺岚的声音穿过中继链路抵达舱内时,还带着地球上办公室的秩序感:清晰、稳定、克制。林予舟甚至能从她停顿的长度判断总控大厅里有多少人在看同一块屏幕。 后来,停顿被拉长。 五秒。 十七秒。 一分钟。 再后来,地球的每一句话都像从更早的时间里寄来。母亲发来的第二条视频在一个姿态修正段后抵达。她说北京降温了,问他那边冷不冷。林予舟看着舷窗外没有温度的黑暗,忽然不知道该怎么回答。 他当然冷。 但那不是气温。 “私人日志,任务日二十。”他说,“今天第一次做梦,梦见自己回到地面,站在厨房里。锅里有水,水一直不开。母亲在旁边说火太小,我低头看,灶台下面接着的是问海二号的离子推进器。” 他说完后,自己笑了一下。 笑声在舱内很短,很快被风机吞掉。 沈从越从设备舱飘过,听见最后半句:“梦境记录?” “心理监测要求。” “别把自己写得太正常。

By Fuyu Jia