GORM 超详细总结

最新推荐文章于 2025-08-02 20:53:50 发布
原创 最新推荐文章于 2025-08-02 20:53:50 发布 · 1.3k 阅读 · 12 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#golang #后端 #go语言 #go #开发语言

GORM 超详细总结

1. GORM 简介

GORM 是 Go 语言的一个 ORM (Object-Relational Mapping) 库，全称为 Go ORM。它提供了友好的 API 来操作数据库，支持多种数据库（MySQL、PostgreSQL、SQLite、SQL Server 等）。

主要特性：

  • 全功能 ORM

  • 关联 (Has One, Has Many, Belongs To, Many To Many, Polymorphism)

  • 钩子 (Before/After Create/Save/Update/Delete/Find)

  • 预加载

  • 事务

  • 复合主键

  • SQL 构建器

  • 自动迁移

  • 日志

  • 可扩展的插件系统

  • 每个特性都有测试覆盖

2. 安装与配置

安装：

go get -u gorm.io/gorm
go get -u gorm.io/driver/mysql  # 或其他数据库驱动

基本配置：

import (
  "gorm.io/gorm"
  "gorm.io/driver/mysql"
)
​
func main() {
  dsn := "user:pass@tcp(127.0.0.1:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local"
  db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
  if err != nil {
    panic("failed to connect database")
  }
  
  // 迁移 schema
  db.AutoMigrate(&Product{})
}

3. 模型定义

基本模型：

type User struct {
  gorm.Model
  Name         string
  Email        *string
  Age          uint8
  Birthday     *time.Time
  MemberNumber sql.NullString
  ActivatedAt  sql.NullTime
}

gorm.Model：

type Model struct {
  ID        uint `gorm:"primarykey"`
  CreatedAt time.Time
  UpdatedAt time.Time
  DeletedAt gorm.DeletedAt `gorm:"index"`
}

字段标签：

type User struct {
  Name string `gorm:"type:varchar(100);uniqueIndex"`
  Age  int    `gorm:"default:18"`
}

常用标签：

  • primaryKey - 主键

  • column - 指定列名

  • type - 列数据类型

  • size - 列大小

  • default - 默认值

  • not null - 非空

  • unique - 唯一

  • uniqueIndex - 唯一索引

  • index - 普通索引

  • check - 检查约束

  • <- - 字段权限（create, update）

  • -> - 字段权限（read）

  • - - 忽略字段

4. CRUD 操作

创建记录：

user := User{Name: "Jinzhu", Age: 18}
​
result := db.Create(&user) // 通过数据的指针来创建
​
user.ID             // 返回插入数据的主键
result.Error        // 返回 error
result.RowsAffected // 返回插入记录的条数

批量创建：

var users = []User{{Name: "jinzhu1"}, {Name: "jinzhu2"}, {Name: "jinzhu3"}}
db.Create(&users)

查询记录：

单条查询：

// 获取第一条记录（主键升序）
db.First(&user)
// SELECT * FROM users ORDER BY id LIMIT 1;
​
// 获取一条记录，没有指定排序字段
db.Take(&user)
// SELECT * FROM users LIMIT 1;
​
// 获取最后一条记录（主键降序）
db.Last(&user)
// SELECT * FROM users ORDER BY id DESC LIMIT 1;
​
result := db.First(&user)
result.RowsAffected // 返回找到的记录数
result.Error        // returns error or nil

条件查询：

// 获取第一条匹配的记录
db.Where("name = ?", "jinzhu").First(&user)
// SELECT * FROM users WHERE name = 'jinzhu' ORDER BY id LIMIT 1;
​
// 获取所有匹配的记录
db.Where("name <> ?", "jinzhu").Find(&users)
// SELECT * FROM users WHERE name <> 'jinzhu';
​
// IN
db.Where("name IN ?", []string{"jinzhu", "jinzhu 2"}).Find(&users)
// SELECT * FROM users WHERE name IN ('jinzhu','jinzhu 2');
​
// LIKE
db.Where("name LIKE ?", "%jin%").Find(&users)
// SELECT * FROM users WHERE name LIKE '%jin%';
​
// AND
db.Where("name = ? AND age >= ?", "jinzhu", "22").Find(&users)
// SELECT * FROM users WHERE name = 'jinzhu' AND age >= 22;
​
// 主键查询
db.First(&user, 10)
// SELECT * FROM users WHERE id = 10;

更新记录：

// 更新单个字段
db.Model(&user).Update("name", "hello")
// UPDATE users SET name='hello', updated_at='2013-11-17 21:34:10' WHERE id=111;
​
// 更新多个字段
db.Model(&user).Updates(User{Name: "hello", Age: 18})
// UPDATE users SET name='hello', age=18, updated_at='2013-11-17 21:34:10' WHERE id=111;
​
// 使用 map 更新多个字段
db.Model(&user).Updates(map[string]interface{}{"name": "hello", "age": 18})

删除记录：

// 删除一条记录
db.Delete(&user)
// DELETE FROM users WHERE id = 10;
​
// 带条件的删除
db.Where("name = ?", "jinzhu").Delete(&user)
// DELETE FROM users WHERE name = 'jinzhu';
​
// 批量删除
db.Delete(&User{}, "name LIKE ?", "%jinzhu%")
// DELETE FROM users WHERE name LIKE '%jinzhu%';

5. 高级查询

预加载：

type User struct {
  gorm.Model
  Name      string
  Orders    []Order
}
​
type Order struct {
  gorm.Model
  UserID uint
  Price  float64
}
​
// 预加载 Orders
db.Preload("Orders").Find(&users)
// SELECT * FROM users;
// SELECT * FROM orders WHERE user_id IN (1,2,3,4);
​
// 嵌套预加载
db.Preload("Orders.OrderItems").Find(&users)

关联查询：

var user User
db.First(&user)
​
var orders []Order
db.Model(&user).Association("Orders").Find(&orders)

作用域：

func AmountGreaterThan1000(db *gorm.DB) *gorm.DB {
  return db.Where("amount > ?", 1000)
}
​
func PaidWithCreditCard(db *gorm.DB) *gorm.DB {
  return db.Where("pay_mode = ?", "card")
}
​
db.Scopes(AmountGreaterThan1000, PaidWithCreditCard).Find(&orders)
// 查找所有金额大于 1000 且使用信用卡支付的订单

原生 SQL：

db.Raw("SELECT id, name FROM users WHERE name = ?", "jinzhu").Scan(&result)
​
db.Exec("DROP TABLE users")

6. 事务

自动事务：

db.Transaction(func(tx *gorm.DB) error {
  // 在事务中执行一些 db 操作
  if err := tx.Create(&Animal{Name: "Giraffe"}).Error; err != nil {
    // 返回任何错误都会回滚事务
    return err
  }
​
  if err := tx.Create(&Animal{Name: "Lion"}).Error; err != nil {
    return err
  }
​
  // 返回 nil 提交事务
  return nil
})

手动事务：

// 开始事务
tx := db.Begin()
​
// 在事务中执行一些 db 操作
if err := tx.Create(&Animal{Name: "Giraffe"}).Error; err != nil {
  tx.Rollback()
  return
}
​
if err := tx.Create(&Animal{Name: "Lion"}).Error; err != nil {
  tx.Rollback()
  return
}
​
// 提交事务
tx.Commit()

7. 钩子（Hooks）

GORM 提供了以下钩子：

  • BeforeSave

  • BeforeCreate

  • AfterCreate

  • BeforeUpdate

  • AfterUpdate

  • BeforeDelete

  • AfterDelete

  • AfterFind

示例：

func (u *User) BeforeCreate(tx *gorm.DB) (err error) {
  u.UUID = uuid.New()
  return
}

8. 性能优化

禁用默认事务：

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
  SkipDefaultTransaction: true,
})

批量插入：

var users = []User{{Name: "jinzhu1"}, {Name: "jinzhu2"}, {Name: "jinzhu3"}}
db.CreateInBatches(users, 100)

查询优化：

// 只查询需要的字段
db.Select("name", "age").Find(&users)
​
// 使用 Pluck 获取单列
var ages []int64
db.Model(&User{}).Pluck("age", &ages)

9. 错误处理

GORM 的错误处理：

if err := db.Where("name = ?", "jinzhu").First(&user).Error; err != nil {
  // 处理错误
  if errors.Is(err, gorm.ErrRecordNotFound) {
    // 记录未找到
  } else {
    // 其他错误
  }
}

10. 扩展功能

自定义数据类型：

type JSON json.RawMessage
​
// 实现 Scanner 和 Valuer 接口
func (j *JSON) Scan(value interface{}) error {
  // 实现扫描逻辑
}
​
func (j JSON) Value() (driver.Value, error) {
  // 实现值逻辑
}

插件开发：

GORM 提供了插件系统，可以开发自定义插件扩展功能。

11. 常见问题

1. 如何关闭日志？

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
  Logger: logger.Default.LogMode(logger.Silent),
})

2. 如何处理软删除？

// 模型包含 gorm.DeletedAt 字段
db.Unscoped().Where("age = 20").Find(&users)
// 查询时会忽略 deleted_at IS NULL 条件
​
db.Unscoped().Delete(&order)
// 永久删除

3. 如何添加表前缀？

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
  NamingStrategy: schema.NamingStrategy{
    TablePrefix: "t_", // 表前缀
  },
})

12. 最佳实践

  1. 模型设计：

    • 使用结构体标签定义字段属性

    • 合理设计关联关系

    • 考虑使用软删除

  2. 查询优化：

    • 只查询需要的字段

    • 合理使用预加载

    • 使用批量操作减少数据库交互

  3. 错误处理：

    • 总是检查错误

    • 区分不同类型的错误（记录未找到、连接错误等）

  4. 事务管理：

    • 对需要原子性操作的使用事务

    • 避免长事务

  5. 性能监控：

    • 使用 GORM 的调试模式检查生成的 SQL

    • 监控慢查询

GORM 是一个功能强大且灵活的 ORM 库，通过合理使用可以大大提高 Go 语言开发中数据库操作的效率和可维护性。

👉 立即点击链接，开启你的全栈开发之路：Golang全栈开发完整课程

Go基础：Go语言ORM框架GORM详解
数据知道的博客
10-05 2374
GORM是Go语言中功能强大的ORM框架，支持MySQL、PostgreSQL等主流数据库。它提供丰富的功能，包括模型定义、CRUD操作、关联处理、事务管理和自动迁移等，同时支持钩子函数和预加载优化。相比原生SQL，GORM虽然存在性能开销，但显著提升了开发效率。安装简单，通过结构体标签定义模型，支持增删改查、事务及复杂查询。其核心优势在于多数据库兼容、开发者友好性及完善的文档支持，适合需要快速开发的场景。
GoLand 项目从 0 到 1：第八天 ——GORM 命名策略陷阱与 Go 项目启动慢问题攻坚
最新发布
weixin_46303384的博客
08-14 362
摘要：开发团队在第八天解决了两个关键技术问题。首先发现了GORM框架的蛇形命名策略导致数据库字段映射失败，通过适配SQL别名或关闭自动转换功能解决了接口数据异常。其次排查出某电脑管家后台服务PCManagerService严重影响Go项目启动速度，停止该进程后编译时间从30秒降至1-2秒。这两个问题的解决为后续开发扫清了障碍，团队对GORM的设计哲学和开发环境优化有了更深理解。（150字）
gorm 中文文档(pdf)
08-07
参照 https://github.com/jasperxu/gorm-cn-doc.git 生成的pdf文档。
gorm 介绍
feiyan35488的专栏
04-06 261
grails 中的gorm框架是基于 hibernage，就是在hibernate基础上进行了一层薄薄的封装。 下面主要讲讲 几种关系  1，1对1     在 class A { B b       }     class B{}     默认会级联  插入和更新     当B 指定 static belongsTo 时，表示指定owner， 这样在删除A时 会将B级联删除 ...
Gorm简介
qq_41891425的博客
12-26 860
简介 gorm主要是把struct类型和数据库表记录进行映射，操作数据库的时候不需要直接手写SQL代码 导入依赖包：github.com/jinzhu/gorm 数据库定义的users表s 字段 属性 id 自增id username 账号 password 密码 createtime 创建时间 Gorm的定义 对应关系 数据库中的username 结构体中 Username password Password createtime CreateTim
golang学习之gorm(一):Gorm介绍
热门推荐
浅弋、璃鱼的博客
11-15 3万+
文章目录一、gorm介绍:1. 什么是orm？2. gorm3.安装4.官方文档： 一、gorm介绍: 1. 什么是orm？ Object-Relationl Mapping，即对象关系映射，这里的Relationl指的是关系型数据库 它的作用是在关系型数据库和对象之间作一个映射，这样，我们在具体的操作数据库的时候，就不需要再去和复杂的SQL语句打交道，只要像平时操作对象一样操作它就可以了 。 2. gorm 1.Golang写的，GitHub上活跃度很高的orm库 2.特点： 全功能ORM; 关联(包含
gorm简介
all_about_WZY的博客
06-17 1544
gorm是一个功能强大的Go编程语言中的ORM库，具有简单易用、多数据库支持、自动迁移、事务支持和强大的查询功能等特点。在复杂的业务逻辑中，事务可以确保一系列操作要么全部成功，要么全部回滚，避免了数据不一致的问题。ORM是一种技术，它将数据库表中的数据映射到面向对象的模型中，从而简化了数据库操作。gorm具有强大的自动迁移功能，可以根据定义的模型自动创建、修改数据库表结构。这简化了数据库结构的管理，减少了手动处理数据库迁移的工作量。接下来，你可以定义你的数据模型，并使用gorm提供的API进行数据库操作。
GORM 数据库索引优化：提升 Golang 查询性能的关键
Golang编程笔记的博客
05-30 763
当你的 Golang 项目用户量逐渐增长，可能会遇到这样的“糟心事”：原本流畅的用户列表查询突然变慢了，订单筛选接口从 200ms 变成 2s，数据库 CPU 使用率飙到 90%……这些问题的背后，90% 都和“索引设计不合理”有关。本文将聚焦GORM（Golang 最流行的 ORM 框架）中的数据库索引优化，覆盖索引基础原理、GORM 索引创建方法、性能分析工具使用、实战优化案例四大核心内容，帮你从“索引小白”变成“优化高手”。用“字典查字”的故事讲清楚索引的本质；
从“gorm建立mysql数据库连接，偶现tcp: i/o timeout问题”简单看gorm.DB源码
08-14
> **根本原因总结**：偶现超时通常因连接池中的空闲连接被 MySQL 服务端关闭后，GORM 未及时检测并重建连接导致。通过合理设置 `SetConnMaxIdleTime` 和超时参数可解决 90% 的案例[^4]。 --- ### 相关问题 1. **...
Go语言Gin框架入门到实践：一篇超详细的Web开发指南
dl999666的博客
08-02 1208
Go 语言（Golang）凭借其简洁的语法、出色的并发性能和高效的编译速度，在微服务和云原生领域大放异彩。而在众多 Go Web 框架中，Gin 以其极致的性能和轻量级的特性脱颖而出，成为最受欢迎和使用最广泛的框架之一。本文将作为你学习 Gin 框架的向导，从环境搭建开始，一步步带你掌握 Gin 的核心功能，并通过一个完整的实战案例，让你真正理解如何使用 Gin 高效地构建 Web 应用和 API。中间件本质上就是一个。下面是一个简单的示例，用于计算请求处理时间。
Golang后端开发：如何设计高性能的数据库表结构
架构师的AI之路，分享AI应用开发架构的学习与实践。
06-06 998
数据库表结构的设计才是系统性能的“地基”。一个糟糕的表结构，即使加了10层缓存，也可能因为一次慢查询拖垮整个系统。本文聚焦Golang后端场景，覆盖MySQL（最常用）的表结构设计，包含字段类型选择、索引优化、范式与反范式平衡、分区分表等核心议题，帮助开发者从“会写SQL”进阶到“会设计高性能表结构”。本文先通过“超市库存管理”的生活案例引出核心概念，再拆解设计原则（字段、索引、范式等），接着用电商订单系统实战演示落地过程，最后总结常见问题与未来趋势。范式与反范式。
GORM介绍及入门指南
MPY_3的博客
07-16 2129
GORM 是一个适用于 Go 语言的 ORM（对象关系映射）库。ORM 的目的是让开发者能够通过面向对象的方式与数据库交互，而不是直接编写 SQL 语句。GORM 使得操作数据库更加高效和便捷，同时保留了 Go 语言的简洁性和灵活性。模型是使用普通结构体定义的。这些结构体可以包含具有基本Go类型、指针或这些类型的别名，甚至是自定义类型（只需要实现 database/sql 包中的Scanner和Valuer接口）。
gorm
bob422720735的博客
06-29 190
func UpdateArticleDetails(title, content, cover, desc, tags, keyword string, menuId, categoryId int, isTop, hot, recommend, prod, markdown bool, id int) error { // 0 草稿箱 1发布 2垃圾箱 var save int if prod { save = 1 } else { save = 0 } a := &m..
01-gorm介绍和基本用法
w7635122886的博客
01-17 404
gorm介绍和基本用法
Gorm—Go语言数据库框架
追求幸福，探索未知的博客
07-30 7070
Go语言最流行的数据库ORM【对象关系映射】框架。
GORM（Grails Object-Relational Mapping）是 Groovy 语言中一个强大的 ORM 框架，用于简化数据库操作
BLOG域名:programb.blog.youkuaiyun.com
05-16 415
GORM (Grails Object Relational Mapping) 是 Grails 框架的核心组件，提供了强大的 ORM 功能。不过，使用过程中存在一些需要注意的常见问题，下面结合 Groovy 语言特点进行分析。
Gorm介绍、数据库连接与模型定义
liu289747235的专栏
02-05 2814
GORM是使用Go语言开发的友好的ORM库。中文官方网站全功能 ORM关联 (拥有一个，拥有多个，属于，多对多，多态，单表继承)Create，Save，Update，Delete，Find 中钩子方法支持 Preload、Joins 的预加载事务，嵌套事务，Save Point，Rollback To to Saved PointContext、预编译模式、DryRun 模式。
go-gorm
qq_40530622的博客
11-22 346
package main import ( "encoding/json" "fmt" "time" "github.com/jinzhu/gorm" _ "github.com/jinzhu/gorm/dialects/mysql" ) var MainDB *gorm.DB func main() { url := "test:123456@tcp(127.0.0.1:3306)/blogger?charset=utf8mb4&parseTime=True&loc=L
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值