gorm 中的Updates Update, Save,Create , UpdateColumn 区别与联系
在 GORM（Go 的 ORM 库）中
Updates、Update、Save、Create、UpdateColumn等方法都用于数据的写入或更新，但它们的行为、触发的钩子（Hooks）、性能、适用场景有显著区别。以下是详细对比与联系:
一、核心方法对比表
| 方法 | 用途 | 是否触发 Hooks | 是否支持批量 | 是否跳过零值 | 是否需要主键 | 备注 |
|---|---|---|---|---|---|---|
Create | 插入新记录 | ✅BeforeCreate,AfterCreate | ❌（单条） ✅ CreateInBatches批量 | ❌（插入所有字段） | ❌ | 自动生成 ID |
Save | 智能保存（存在则更新，否则插入） | ✅ 全部 Hooks （ BeforeCreate/Update,After...） | ❌（单条） | ❌（更新所有非零字段） | ✅（更新时需主键） | 最“重”的操作，慎用 |
Update | 更新单个字段 | ❌（不触发BeforeUpdate） | ❌ | ✅（可更新为零值） | ✅（或配合Where） | 如Update("name", "new") |
Updates | 更新多个字段 | ⚠️仅当传 struct 时触发 ❌传 map不触发 | ✅（配合Where） | ✅（struct 会跳过零值；map 不会） | ✅（或配合Where） | 最常用批量更新方式 |
UpdateColumn | 强制更新字段（包括零值） | ❌ | ✅ | ❌（强制更新，含零值） | ✅（或配合Where） | 绕过 GORM 安全机制 |
二、逐个详解
1.Create
db.Create(&user)- 作用：插入一条新记录。
- 特点：
- 忽略主键（自增或 UUID）
- 插入所有字段（包括零值，如
"",0） - 触发
BeforeCreate/AfterCreate
- 不适用：已有主键的记录（可能报错或行为未定义）
2.Save
db.Save(&user) // user.Id != 0 → 更新；user.Id == 0 → 插入- 作用：根据主键是否存在，自动决定是
INSERT还是UPDATE - 特点：
- 更新时会更新所有非零字段（零值字段会被忽略！⚠️ 常见坑）
- 触发完整 Hooks（
BeforeCreate/BeforeUpdate等） - 必须有主键才能更新。
- 缺点：
- 性能差（先查？不一定，但逻辑复杂）
- 零值字段无法更新（比如想把
name改成""不行）
- 建议：除非明确需要“智能保存”，否则避免使用
3.Update（单字段）
db.Model(&User{}).Where("id = ?", 1).Update("name", "new") // 或 db.Model(&user).Update("name", "new")- 作用：更新单个字段
- 特点：
- 不触发
BeforeUpdate - 可更新为零值（如
Update("age", 0)有效） - 必须配合
Model()+Where()或已有主键
- 不触发
- 适用：简单单字段更新
4.Updates（多字段）
(a)传map（最常用）
db.Model(&User{}).Where("id = ?", 1).Updates(map[string]interface{}{ "name": "new", "age": 0, })- 不触发 Hooks
- 不会跳过零值（
age: 0会被更新） - 高效，适合批量更新
(b) 传struct
db.Model(&User{}).Where("id = ?", 1).Updates(User{Name: "new", Age: 0})- 会触发
BeforeUpdate/AfterUpdate - 会跳过零值字段（
Age: 0被忽略！） - 如果想更新零值，需用指针或
sql.NullInt64等
💡关键区别：
Updates(map)vsUpdates(struct)行为完全不同！
5.UpdateColumn
db.Model(&User{}).Where("id = ?", 1).UpdateColumn("name", "")- 作用：强制更新字段，即使值为零值。
- 不触发任何 Hooks
- 绕过 GORM 的安全检查（如字段不存在也会拼 SQL，可能报错）
- 批量更新零值的唯一可靠方式
⚠️ 危险！慎用，确保字段名正确
三、钩子（Hooks）触发规则总结
| 方法 | 触发BeforeUpdate? |
|---|---|
Save(&struct) | ✅ |
Updates(&struct{}) | ✅ |
Updates(map[...]) | ❌ |
Update("field", value) | ❌ |
UpdateColumn(...) | ❌ |
Create | ✅（BeforeCreate） |
核心原则：只有通过struct 实例更新（且 GORM 能识别为模型操作），才会触发 Hooks
在 GORM 中，使用
Updates时是否触发 Hooks（如BeforeUpdate/AfterUpdate）与是否开启事务无关，不仅看Updates的参数类型，还看Model()是否绑定了一个 struct 实例 ,传入的是map还是struct结论：
只要用
map[string]interface{}调用Updates，无论是否在事务中，都不会触发任何 Hooks。这是 GORM 的设计行为，事务不影响钩子的触发逻辑
临时跳过钩子：
使用原生 SQL或Session 模式
如果模型已经定义了钩子，但某些特定操作想跳过钩子，可以：
方法一：使用
Session(&gorm.Session{SkipHooks: true})db.Session(&gorm.Session{SkipHooks: true}).Create(&user) db.Session(&gorm.Session{SkipHooks: true}).Save(&user) db.Session(&gorm.Session{SkipHooks: true}).Delete(&user)⚠️ 注意：
SkipHooks: true会跳过所有钩子（包括BeforeCreate、AfterCreate等），但不会跳过AfterFind，因为AfterFind是在查询后自动调用的，与写操作无关。方法二：使用原生 SQL（完全绕过 GORM 模型机制）
db.Exec("INSERT INTO users (name) VALUES (?)", "Alice")这种方式不会触发任何 GORM 钩子，因为没有使用模型的 Create/Save 等方法
四、如何选择
| 场景 | 推荐方法 |
|---|---|
| 插入新记录 | Create |
| 更新部分字段（含零值），批量 | Updates(map)+ 手动设updated_at |
更新部分字段，需触发BeforeUpdate | Updates(&struct{})（注意零值问题） |
| 强制更新字段为零值 | UpdateColumn |
| 不确定是新增还是更新 | 避免Save，改用FirstOrCreate+ 显式更新 |
| 单字段更新 | Update("field", value) |
五、最佳实践建议
- 批量更新不要依赖 Hooks，显式设置
updated_at、updated_by- 避免使用
Save，除非你完全理解其零值行为Updates(map)是最安全高效的批量更新方式- 如果
BeforeUpdate只是用来设时间戳，直接在业务层赋值，比依赖钩子更可靠- 想更新零值？用
map或UpdateColumn，别用 struct