// 正確示例（反引號(hào)包裹、鍵值對(duì)格式正確）
type User struct {
    Name string `json:"username" doc:"用戶(hù)姓名" validate:"required"`
    Age  int    `gorm:"column:user_age;type:int(3)"`
}
// 錯(cuò)誤示例（常見(jiàn)踩坑點(diǎn)）
type UserWrong struct {
    // 錯(cuò)誤1：用雙引號(hào)包裹標(biāo)簽，會(huì)被解析為普通字符串
    Name string "json:'username'"
    // 錯(cuò)誤2：多個(gè)鍵值對(duì)用逗號(hào)分隔，反射無(wú)法識(shí)別
    Age  int    `gorm:"column:user_age",validate:"gte=18"`
    // 錯(cuò)誤3：值未用雙引號(hào)包裹，語(yǔ)法不規(guī)范
    Sex  string `doc:男/女`
}

package main
import (
    "encoding/json"
    "fmt"
)
// 定義帶有json標(biāo)簽的結(jié)構(gòu)體
type User struct {
    Name     string `json:"username"`       // 自定義JSON鍵名
    Age      int    `json:"age,omitempty"`  // 空值不顯示
    Password string `json:"-"`              // 不參與JSON序列化
    Sex      int    `json:"sex,string"`     // 轉(zhuǎn)換為字符串序列化
}
func main() {
    // 1. 結(jié)構(gòu)體轉(zhuǎn)JSON（序列化）
    user := User{
        Name:     "張三",
        Age:      0,      // 空值，會(huì)被omitempty忽略
        Password: "123456",// 會(huì)被json:"-"忽略
        Sex:      1,
    }
    jsonStr, err := json.Marshal(user)
    if err != nil {
        fmt.Println("JSON序列化失?。?, err)
        return
    }
    fmt.Println("序列化結(jié)果：", string(jsonStr)) // 輸出：{"username":"張三","sex":"1"}
    // 2. JSON轉(zhuǎn)結(jié)構(gòu)體（反序列化）
    jsonStr2 := `{"username":"李四","age":20,"sex":"0"}`
    var user2 User
    err = json.Unmarshal([]byte(jsonStr2), &user2)
    if err != nil {
        fmt.Println("JSON反序列化失?。?, err)
        return
    }
    fmt.Println("反序列化結(jié)果：", user2) // 輸出：{李四 20  0}
}

package main
import (
    "gorm.io/driver/mysql"
    "gorm.io/gorm"
    "fmt"
)
// 定義帶有g(shù)orm標(biāo)簽的結(jié)構(gòu)體（對(duì)應(yīng)數(shù)據(jù)庫(kù)表users）
type User struct {
    ID       int    `gorm:"column:user_id;primaryKey;autoIncrement"` // 主鍵自增
    Name     string `gorm:"column:user_name;type:varchar(50);not null;comment:用戶(hù)姓名"`
    Age      int    `gorm:"column:user_age;type:int(3);default:0;comment:用戶(hù)年齡"`
    Email    string `gorm:"column:user_email;type:varchar(100);unique;comment:用戶(hù)郵箱（唯一）"`
    Password string `gorm:"column:user_password;type:varchar(100);not null;comment:用戶(hù)密碼"`
}
// 自定義表名（可選，默認(rèn)表名為結(jié)構(gòu)體復(fù)數(shù)形式users）
func (u User) TableName() string {
    return "users"
}
func main() {
    // 1. 連接數(shù)據(jù)庫(kù)（替換為自己的數(shù)據(jù)庫(kù)信息）
    dsn := "root:123456@tcp(127.0.0.1:3306)/test?charset=utf8mb4&parseTime=True&loc=Local"
    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{})
    if err != nil {
        panic("數(shù)據(jù)庫(kù)連接失?。? + err.Error())
    }
    // 2. 根據(jù)結(jié)構(gòu)體創(chuàng)建表（自動(dòng)根據(jù)gorm標(biāo)簽生成列屬性）
    err = db.AutoMigrate(&User{})
    if err != nil {
        panic("創(chuàng)建表失?。? + err.Error())
    }
    fmt.Println("表創(chuàng)建成功（若不存在）")
    // 3. 插入數(shù)據(jù)（ORM自動(dòng)映射結(jié)構(gòu)體字段與數(shù)據(jù)庫(kù)列）
    user := User{
        Name:     "張三",
        Age:      25,
        Email:    "zhangsan@163.com",
        Password: "123456",
    }
    db.Create(&user)
    fmt.Println("插入數(shù)據(jù)成功，用戶(hù)ID：", user.ID)
}

package main
import (
    "fmt"
    "github.com/go-playground/validator/v10"
)
// 定義帶有validate標(biāo)簽的請(qǐng)求結(jié)構(gòu)體
type RegisterRequest struct {
    Username string `json:"username" validate:"required,min=6,max=20"` // 必填，長(zhǎng)度6-20
    Email    string `json:"email" validate:"required,email"`          // 必填，合法郵箱
    Age      int    `json:"age" validate:"required,gte=18,lte=120"`   // 必填，年齡18-120
    Password string `json:"password" validate:"required,len=6"`       // 必填，長(zhǎng)度6
    Sex      string `json:"sex" validate:"required,oneof=male female"`// 必填，只能是male/female
}
func main() {
    // 1. 初始化校驗(yàn)器
    validate := validator.New()
    // 2. 模擬請(qǐng)求參數(shù)（不符合校驗(yàn)規(guī)則的示例）
    req := RegisterRequest{
        Username: "zhangsan", // 長(zhǎng)度8，符合要求
        Email:    "zhangsan163.com", // 不合法郵箱（缺少@）
        Age:      17,         // 年齡17，不符合gte=18
        Password: "12345",    // 長(zhǎng)度5，不符合len=6
        Sex:      "man",      // 不是指定選項(xiàng)（male/female）
    }
    // 3. 執(zhí)行校驗(yàn)
    err := validate.Struct(req)
    if err != nil {
        // 4. 輸出校驗(yàn)失敗信息
        for _, err := range err.(validator.ValidationErrors) {
            fmt.Printf("參數(shù)校驗(yàn)失?。?s（字段：%s，要求：%s）\n", 
                err.Error(), err.Field(), err.Tag())
        }
        return
    }
    fmt.Println("參數(shù)校驗(yàn)通過(guò)，可以執(zhí)行注冊(cè)邏輯")
}

package main
import (
    "github.com/gin-gonic/gin"
    "net/http"
)
// 定義帶有form和doc標(biāo)簽的結(jié)構(gòu)體（用于表單提交）
type LoginForm struct {
    Username string `form:"user_name" doc:"登錄用戶(hù)名，長(zhǎng)度6-20位" validate:"required,min=6,max=20"`
    Password string `form:"user_password" doc:"登錄密碼，長(zhǎng)度6位" validate:"required,len=6"`
    Remember bool   `form:"remember_me" doc:"是否記住登錄狀態(tài)，默認(rèn)false"`
}
func main() {
    // 初始化gin引擎
    r := gin.Default()
    // 定義登錄接口（表單提交）
    r.POST("/login", func(c *gin.Context) {
        var form LoginForm
        // 自動(dòng)綁定表單參數(shù)（根據(jù)form標(biāo)簽匹配）
        if err := c.ShouldBindForm(&form); err != nil {
            c.JSON(http.StatusBadRequest, gin.H{
                "code": 400,
                "msg":  "表單參數(shù)錯(cuò)誤",
                "err":  err.Error(),
            })
            return
        }
        // 這里可以添加參數(shù)校驗(yàn)、登錄邏輯（省略）
        c.JSON(http.StatusOK, gin.H{
            "code": 200,
            "msg":  "登錄成功",
            "data": form,
        })
    })
    // 啟動(dòng)服務(wù)
    r.Run(":8080")
    // 測(cè)試：訪(fǎng)問(wèn)http://localhost:8080/login，提交表單參數(shù)user_name、user_password、remember_me
    // 文檔生成：配合swaggo庫(kù)，可自動(dòng)讀取doc標(biāo)簽，生成接口文檔
}

package main
import (
    "fmt"
    "reflect"
)
// 定義帶有多個(gè)標(biāo)簽的結(jié)構(gòu)體（模擬語(yǔ)雀鏈接中的場(chǎng)景）
type Resume struct {
    Name  string `json:"name" doc:"我的名字"`
    Age   int    `json:"age" doc:"我的年齡"`
    Email string `json:"email" doc:"我的郵箱" validate:"required,email"`
}
// findDoc：通過(guò)反射讀取結(jié)構(gòu)體的doc標(biāo)簽，返回json標(biāo)簽與doc標(biāo)簽的映射
func findDoc(stru interface{}) map[string]string {
    // 1. 獲取反射類(lèi)型（Type），判斷是否為指針
    t := reflect.TypeOf(stru)
    if t.Kind() != reflect.Ptr {
        fmt.Println("錯(cuò)誤：傳入的必須是結(jié)構(gòu)體指針")
        return nil
    }
    // 2. 獲取指針指向的實(shí)際結(jié)構(gòu)體類(lèi)型
    t = t.Elem()
    if t.Kind() != reflect.Struct {
        fmt.Println("錯(cuò)誤：傳入的指針必須指向結(jié)構(gòu)體")
        return nil
    }
    // 3. 遍歷結(jié)構(gòu)體的所有字段，讀取標(biāo)簽
    docMap := make(map[string]string)
    // 獲取結(jié)構(gòu)體字段數(shù)量
    fieldCount := t.NumField()
    for i := 0; i < fieldCount; i++ {
        // 獲取第i個(gè)字段
        field := t.Field(i)
        // 讀取json標(biāo)簽的值（作為map的鍵）
        jsonKey := field.Tag.Get("json")
        // 讀取doc標(biāo)簽的值（作為map的值）
        docValue := field.Tag.Get("doc")
        // 存入map（跳過(guò)json標(biāo)簽為空的字段）
        if jsonKey != "" {
            docMap[jsonKey] = docValue
        }
    }
    return docMap
}
func main() {
    // 創(chuàng)建結(jié)構(gòu)體實(shí)例
    resume := Resume{
        Name:  "張三",
        Age:   25,
        Email: "zhangsan@163.com",
    }
    // 傳入結(jié)構(gòu)體指針，讀取doc標(biāo)簽
    docMap := findDoc(&resume)
    fmt.Println("json標(biāo)簽與doc標(biāo)簽的映射：", docMap)
    // 輸出：map[age:我的年齡 email:我的郵箱 name:我的名字]
    // 讀取指定json標(biāo)簽對(duì)應(yīng)的doc說(shuō)明
    fmt.Println("name對(duì)應(yīng)的說(shuō)明：", docMap["name"]) // 輸出：我的名字
}

// 錯(cuò)誤
type User struct {
    Name string "json:'username'" // 雙引號(hào)包裹，反射讀不到
}
// 正確
type User struct {
    Name string `json:"username"` // 反引號(hào)包裹
}

// 錯(cuò)誤
type User struct {
    Name string `json:"username",doc:"用戶(hù)姓名"` // 逗號(hào)分隔，錯(cuò)誤
}
// 正確
type User struct {
    Name string `json:"username" doc:"用戶(hù)姓名"` // 空格分隔，正確
}

// 錯(cuò)誤
type User struct {
    Name string `json:username` // 值未用雙引號(hào)，錯(cuò)誤
}
// 正確
type User struct {
    Name string `json:"username"` // 值用雙引號(hào)，正確
}