Skip to main content

概览

GORM 是 Go 语言中一个功能极其强大的 ORM 库。

功能特性​

  • 全功能 ORM: 覆盖了大多数 ORM 的功能。
  • 关联 (Associations): 支持一对一 (Has One), 一对多 (Has Many), 多对一 (Belongs To), 多对多 (Many To Many), 多态关联 (Polymorphism), 单表继承 (Single-table inheritance)。
  • 钩子 (Hooks): 支持在 创建/保存/更新/删除/查找 之前/之后 (Before/After) 定义钩子函数。
  • 预加载 (Preloading): 支持急切加载 (Eager loading) 关联数据。
  • 事务 (Transactions): 支持嵌套事务、保存点 (Save Point)、回滚到保存点。
  • 上下文 (Context): 支持上下文感知，可以用于超时控制、链路追踪等。
  • 批量插入 (Batch Insert): 高效的批量数据插入支持。
  • SQL 构建器 (SQL Builder): 内置 SQL 构建器，也支持执行原生 SQL。
  • 自动迁移 (Auto Migration): 自动根据模型结构保持数据库表结构的更新。
  • 日志 (Logger): 灵活的日志记录接口。
  • 可扩展性: 基于插件的架构，支持编写插件扩展功能 (如读写分离, 数据库分片等)。
  • 全面测试: 拥有 extensive 的测试覆盖率，保证稳定性。
  • 开发者友好: 极少的配置，开箱即用。

安装​

go get -u gorm.io/gorm
go get -u gorm.io/driver/sqlite

快速开始​

package main

import (
  "gorm.io/gorm"
  "gorm.io/driver/sqlite"
)

type Product struct {
  gorm.Model
  Code  string
  Price uint
}

func main() {
  db, err := gorm.Open(sqlite.Open("test.db"), &gorm.Config{})
  if err != nil {
    panic("failed to connect database")
  }

  // 迁移 schema
  db.AutoMigrate(&Product{})

  // Create
  db.Create(&Product{Code: "D42", Price: 100})

  // Read
  var product Product
  db.First(&product, 1) // 根据整型主键查找
  db.First(&product, "code = ?", "D42") // 查找 code 字段值为 D42 的记录

  // Update - 将 product 的 price 更新为 200
  db.Model(&product).Update("Price", 200)
  // Update - 更新多个字段
  db.Model(&product).Updates(Product{Price: 200, Code: "F42"}) // 仅更新非零值字段
  db.Model(&product).Updates(map[string]interface{}{"Price": 200, "Code": "F42"})

  // Delete - 删除 product
  db.Delete(&product, 1)
}