模型定义

// gorm.Model 的定义
type Model struct {
    ID        uint           `gorm:"primaryKey"`
    CreatedAt time.Time
    UpdatedAt time.Time
    DeletedAt gorm.DeletedAt `gorm:"index"`
}

// 嵌入 gorm.Model
type User struct {
    gorm.Model
    Name string
    Age  int
}

// 等价于：
type User struct {
    ID        uint           `gorm:"primaryKey"`
    CreatedAt time.Time
    UpdatedAt time.Time
    DeletedAt gorm.DeletedAt `gorm:"index"`
    Name      string
    Age       int
}

import "gorm.io/gorm/schema"

db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
    NamingStrategy: schema.NamingStrategy{
        TablePrefix:   "t_",     // 表名前缀 → "t_users"
        SingularTable: true,     // 单数表名 → "user" 而非 "users"
        NoLowerCase:   true,     // 保持大写 → "User"
        NameReplacer:  strings.NewReplacer("CID", "Cid"), // 自定义替换
    },
})

type User struct {
    ID        uint   `gorm:"primaryKey;autoIncrement;comment:用户ID"`
    Email     string `gorm:"type:varchar(100);uniqueIndex;not null;comment:邮箱"`
    Name      string `gorm:"size:100;default:'';comment:昵称"`
    Age       int    `gorm:"default:0;check:age >= 0;comment:年龄"`
    Balance   float64 `gorm:"type:decimal(10,2);default:0.00"`
    IsActive  bool   `gorm:"default:true"`
    Metadata  string `gorm:"type:json;serializer:json"`
    CreatedAt int64  `gorm:"autoCreateTime:milli"` // 毫秒时间戳
    UpdatedAt int64  `gorm:"autoUpdateTime:milli"`
}

type User struct {
    ID        uint   `gorm:"primaryKey"`
    Name      string `gorm:"<-"`           // 允许读写（默认）
    Password  string `gorm:"<-:false"`     // 禁止写入（从 DB 读，不写回）
    Secret    string `gorm:"->:false"`     // 禁止读取（写入 DB，不读出）
    Internal  string `gorm:"-"`            // 完全忽略
    Token     string `gorm:"<-:create"`    // 仅创建时写入
    UpdatedBy string `gorm:"<-:update"`    // 仅更新时写入
}

// <-:false 的典型使用场景：密码哈希，只从数据库读取但通过其他方式写入
// 更新时 Password 字段不会被 Updates 覆盖
db.Model(&user).Updates(User{Name: "新名字", Password: "xxx"}) // Password 忽略

type User struct {
    ID        uint      `gorm:"primaryKey"`
    CreatedAt time.Time // 秒级精度，创建时自动设置
    UpdatedAt time.Time // 秒级精度，更新时自动设置
    DeletedAt gorm.DeletedAt `gorm:"index"` // 软删除
}

type User struct {
    ID        uint  `gorm:"primaryKey"`
    CreatedAt int64 `gorm:"autoCreateTime:milli"` // 毫秒时间戳
    UpdatedAt int64 `gorm:"autoUpdateTime:milli"` // 毫秒时间戳
}

type User struct {
    Birthday *time.Time `gorm:"type:date"`          // 日期
    LoginAt  time.Time  `gorm:"type:datetime(3)"`   // 毫秒精度
    Extra    time.Time  `gorm:"type:timestamp"`      // 时间戳
}

// 嵌入结构体（embedded: 展开字段）
type Audit struct {
    CreatedBy string `gorm:"size:100;comment:创建人"`
    UpdatedBy string `gorm:"size:100;comment:更新人"`
}

type User struct {
    gorm.Model
    Name string
    Audit // 字段展开到 users 表
}
// 生成列：id, created_at, updated_at, deleted_at, name, created_by, updated_by

type User2 struct {
    gorm.Model
    Name  string
    Audit Audit `gorm:"embedded;embeddedPrefix:audit_"` // 带前缀
}
// 生成列：..., audit_created_by, audit_updated_by

// 指针嵌入
type User3 struct {
    gorm.Model
    Name  string
    Audit *Audit `gorm:"embedded"` // NULL 可选的嵌入
}

type User struct {
    ID     uint   `gorm:"primaryKey"`
    Name   string `gorm:"default:未命名"`
    Age    int    `gorm:"default:18"`
    IsVIP  bool   `gorm:"default:false"`    // 注意：false 是零值，需特殊处理
    Status string `gorm:"default:active"`
    Bio    string `gorm:"default:NULL"`     // NULL 默认值
}

// 结构体零值字段不会被写入 INSERT（让数据库默认值生效）
db.Create(&User{Name: "张三"})
// INSERT INTO users (name) VALUES ('张三')
// Age 用数据库默认值 18，IsVIP 用 false

// 要显式写入零值，使用指针类型或 Select
db.Select("Age", "IsVIP").Create(&User{Name: "张三"})
// INSERT INTO users (name, age, is_vip) VALUES ('张三', 0, false)

// 推荐：使用指针表示"可能为零值"的字段
type User struct {
    Age   *int  `gorm:"default:18"` // nil → 用默认值，非 nil → 写入具体值
    IsVIP *bool `gorm:"default:false"`
}

age := 0
db.Create(&User{Name: "张三", Age: &age}) // 显式写入 Age=0
db.Create(&User{Name: "李四"})             // Age 用数据库默认值

// 方式一：实现 Tabler 接口（优先级最高）
func (User) TableName() string {
    return "sys_users"
}

// 方式二：临时指定表名
db.Table("sys_users").Find(&users)

// 方式三：通过 NamingStrategy 全局设置（见上文）

type User struct {
    ID        uint   `gorm:"primaryKey;column:user_id"` // 自定义列名
    UserName  string `gorm:"column:username"`            // 自定义列名
    PassWord  string `gorm:"column:pass_word"`           // 与蛇形命名一致，可省略
}