The fantastic ORM library for Golang aims to be developer friendly.

特性

• 全功能 ORM
• 关联 (Has One，Has Many，Belongs To，Many To Many，多态，单表继承)
• Create，Save，Update，Delete，Find 中钩子方法
• 支持 Preload、Joins 的预加载
• 事务，嵌套事务，Save Point，Rollback To Saved Point
• Context、预编译模式、DryRun 模式
• 批量插入，FindInBatches，Find/Create with Map，使用 SQL 表达式、Context Valuer 进行 CRUD
• SQL 构建器，Upsert，数据库锁，Optimizer/Index/Comment Hint，命名参数，子查询
• 复合主键，索引，约束
• Auto Migration
• 自定义 Logger
• 灵活的可扩展插件 API：Database Resolver（多数据库，读写分离）、Prometheus…
• 每个特性都经过了测试的重重考验
• 开发者友好

安装

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

快速入门

1. package main

3. import (
4. "gorm.io/gorm"
5. "gorm.io/driver/sqlite"
6. )

8. type Product struct {
9. gorm.Model
10. Code  string
11. Price uint
12. }

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

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

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

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

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

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