模型与 AutoMigrate
定义模式并执行迁移
模型与 AutoMigrate 是 CoddyKit 上的免费 Go Academy 课时。 这是第 1 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 Go Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 Go Academy 课程共包含 4 节课。
什么是 GORM
GORM 是 Go 最流行的 ORM。它会将 Go 结构体映射到数据库表，让您可以处理对象而不是原始 SQL。它支持 PostgreSQL、MySQL、SQLite 等数据库。
- 结构体到表的映射
- 自动迁移
- 关联和钩子
定义模型
模型就是一个 Go 结构体。每个导出的字段都会成为一列。嵌入 gorm.Model 会添加 ID、CreatedAt、UpdatedAt 和 DeletedAt 字段。
type User struct {
gorm.Model
Name string
Email string
Age int
}字段标签
结构体标签可以自定义列。您可以通过 gorm 标签设置大小、唯一性、索引和默认值。标签写在字段类型后的反引号中，例如 gorm:"uniqueIndex;size:255"。
type User struct {
// ID uint tag: gorm:"primaryKey"
// Email string tag: gorm:"uniqueIndex;size:255"
// Name string tag: gorm:"not null"
ID uint
Email string
Name string
}命名约定
GORM 默认会将名称变为复数并采用蛇形命名：User 结构体映射到 users 表，CreatedAt 字段映射到 created_at。您可以覆盖这些默认规则。
使用 GORM 打开连接
gorm.Open 接受适用于您数据库的方言器，并返回一个 *gorm.DB。这个句柄封装了连接池。
db, err := gorm.Open(postgres.Open(dsn), &gorm.Config{})
if err != nil {
log.Fatal(err)
}AutoMigrate
AutoMigrate 会创建表、缺失的列和索引，使其与您的结构体匹配。它是添加式的：不会删除列，也不会破坏性地修改类型。
db.AutoMigrate(&User{}, &Product{})AutoMigrate 不会做什么
AutoMigrate 从不删除未使用的列，也不会缩小类型，以避免数据丢失。对于重命名、删除或类型更改，您需要使用明确的迁移工具。
可运行的模型映射模拟
GORM 需要真实的数据库驱动程序，因此这个可运行示例模拟 AutoMigrate 执行的蛇形命名表和列映射。
package main
import (
"fmt"
"strings"
)
func toSnake(s string) string {
var b strings.Builder
for i, r := range s {
if i > 0 && r >= 65 && r <= 90 {
b.WriteByte(95)
}
if r >= 65 && r <= 90 {
r = r + 32
}
b.WriteRune(r)
}
return b.String()
}
func main() {
model := "User"
fields := []string{"ID", "Name", "CreatedAt"}
fmt.Println("table:", toSnake(model)+"s")
for _, f := range fields {
fmt.Println("column:", toSnake(f))
}
}DeletedAt 字段
如果您的模型嵌入了 gorm.Model，或者具有 gorm.DeletedAt 字段，GORM 就会启用软删除。被删除的行会获得时间戳，并在查询中被隐藏，而不是直接移除。
自定义表名
在模型上实现 TableName 方法即可覆盖默认名称。当您的架构使用不符合 GORM 约定的名称时，这会很有用。
func (User) TableName() string {
return "app_users"
}外部软件包说明
GORM 及其数据库方言器位于标准库之外，需要使用 go get gorm.io/gorm 以及类似 gorm.io/driver/postgres 的驱动程序。这里的 GORM 代码片段仅用于说明。
快速检查
请测试您对模型的了解。
总结
您已经学会了模型和 AutoMigrate：
- 结构体映射到表；gorm.Model 添加 ID 和时间戳
- 标签设置主键、索引和约束
- 默认命名采用复数形式和蛇形命名
- AutoMigrate 是添加式的，从不执行破坏性操作
- DeletedAt 启用软删除
常见问题解答
「模型与 AutoMigrate」课时是免费的吗？
是的 — 「模型与 AutoMigrate」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 Go Academy 课程的其余内容，请升级到 CoddyKit PRO。 Go Academy 课程共包含 4 节课。
「模型与 AutoMigrate」这节课中我会学到什么？
定义模式并执行迁移 你通过在浏览器中直接运行的动手代码来练习 Go Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 Go Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 Go Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 1 节课，共 4 节。
「模型与 AutoMigrate」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 Go Academy 课中编写并运行代码吗？
能。每节 Go Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。