為什么 Go 語言 struct 要使用 tags

原文鏈接：為什么 Go 語言 struct 要使用 tags

在 Go 語言中，struct 是一種常見的資料型別，它可以用來表示復雜的資料結構，在 struct 中，我們可以定義多個欄位，每個欄位可以有不同的型別和名稱，

除了這些基本資訊之外，Go 還提供了 struct tags，它可以用來指定 struct 中每個欄位的元資訊，

在本文中，我們將探討為什么 Go 語言中需要使用 struct tags，以及 struct tags 的使用場景和優勢，

struct tags 的使用

struct tags 使用還是很廣泛的，特別是在 json 序列化，或者是資料庫 ORM 映射方面，

在定義上，它以 key:value 的形式出現，跟在 struct 欄位后面，除此之外，還有以下幾點需要注意：

使用反引號

在宣告 struct tag 時，使用反引號 ` 包圍 tag 的值，可以防止轉義字符的影響，使 tag 更容易讀取和理解，例如：

type User struct {
    ID    int    `json:"id" db:"id"`
    Name  string `json:"name" db:"name"`
    Email string `json:"email" db:"email"`
}

避免使用空格

在 struct tag 中，應該避免使用空格，特別是在 tag 名稱和 tag 值之間，使用空格可能會導致編碼或解碼錯誤，并使代碼更難以維護，例如：

// 不規范的寫法
type User struct {
    ID    int    `json: "id" db: "id"`
    Name  string `json: "name" db: "name"`
    Email string `json: "email" db: "email"`
}

// 規范的寫法
type User struct {
    ID    int    `json:"id" db:"id"`
    Name  string `json:"name" db:"name"`
    Email string `json:"email" db:"email"`
}

避免重復

在 struct 中，應該避免重復使用同一個 tag 名稱，如果重復使用同一個 tag 名稱，編譯器可能會無法識別 tag，從而導致編碼或解碼錯誤，例如：

// 不規范的寫法
type User struct {
    ID    int    `json:"id" db:"id"`
    Name  string `json:"name" db:"name"`
    Email string `json:"email" db:"name"`
}

// 規范的寫法
type User struct {
    ID    int    `json:"id" db:"id"`
    Name  string `json:"name" db:"name"`
    Email string `json:"email" db:"email"`
}

使用標準化的 tag 名稱

為了使 struct tag 更加標準化和易于維護，應該使用一些標準化的 tag 名稱，

例如，對于序列化和反序列化，可以使用 json、xml、yaml 等；對于資料庫操作，可以使用 db，

type User struct {
    ID       int    `json:"id" db:"id"`
    Name     string `json:"name" db:"name"`
    Password string `json:"-" db:"password"` // 忽略該欄位
    Email    string `json:"email" db:"email"`
}

其中，Password 欄位后面的 - 表示忽略該欄位，也就是說該欄位不會被序列化或反序列化，

多個 tag 值

如果一個欄位需要指定多個 tag 值，可以使用 , 將多個 tag 值分隔開，例如：

type User struct {
    ID        int    `json:"id" db:"id"`
    Name      string `json:"name" db:"name"`
    Email     string `json:"email,omitempty" db:"email,omitempty"`
}

其中 omitempty 表示如果該欄位值為空，則不序列化該欄位，

struct tags 的原理

Go 的反射庫提供了一些方法，可以讓我們在程式運行時獲取和決議結構體標簽，

介紹這些方法之前，先來看看 reflect.StructField ，它是描述結構體欄位的資料型別，定義如下：

type StructField struct {
    Name      string      // 欄位名
    Type      Type        // 欄位型別
    Tag       StructTag   // 欄位標簽
}

結構體中還有一些其他欄位，被我省略了，只保留了和本文相關的，

在結構體的反射中，我們經常使用 reflect.TypeOf 獲取型別資訊，然后使用 Type.Field 或 Type.FieldByName() 獲取結構體欄位的 reflect.StructField，然后根據 StructField 中的資訊做進一步處理，

例如，可以通過 StructField.Tag.Get 方法獲取結構體欄位的標簽值，

下面看一段代碼：

package main

import (
    "fmt"
    "reflect"
)

type User struct {
    Name string `json:"name"`
    Age  int    `json:"age"`
}

type Manager struct {
    Title string `json:"title"`
    User
}

func main() {
    m := Manager{Title: "Manager", User: User{Name: "Alice", Age: 25}}

    mt := reflect.TypeOf(m)

    // 獲取 User 欄位的 reflect.StructField
    userField, _ := mt.FieldByName("User")
    fmt.Println("Field 'User' exists:", userField.Name, userField.Type)

    // 獲取 User.Name 欄位的 reflect.StructField
    nameField, _ := userField.Type.FieldByName("Name")
    tag := nameField.Tag.Get("json")
    fmt.Println("User.Name tag:", tag)
}

運行以上代碼，輸出結果如下：

Field 'User' exists: User {string int}
User.Name tag: "name"

struct tags 的優勢

使用 struct tag 的主要優勢之一是可以在運行時通過反射來訪問和操作 struct 中的欄位，

比如在 Go Web 開發中，常常需要將 HTTP 請求中的引數系結到一個 struct 中，這時，我們可以使用 struct tag 指定每個欄位對應的引數名稱、驗證規則等資訊，在接收到 HTTP 請求時，就可以使用反射機制讀取這些資訊，并根據資訊來驗證引數是否合法，

另外，在將 struct 序列化為 JSON 或者其他格式時，我們也可以使用 struct tag 來指定每個欄位在序列化時的名稱和規則，

此外，使用 struct tag 還可以提高代碼的可讀性和可維護性，在一個大型的專案中，struct 中的欄位通常會包含很多不同的元資訊，比如資料庫中的表名、欄位名、索引、驗證規則等等，

如果沒有 struct tag，我們可能需要將這些元資訊放在注釋中或者在代碼中進行硬編碼，這樣會讓代碼變得難以維護和修改，而使用 struct tag 可以將這些元資訊與 struct 欄位緊密關聯起來，使代碼更加清晰和易于維護，

常用的 struct tags

在 Go 的官方 wiki 中，有一個常用的 struct tags 的庫的串列，我復制在下面了，感興趣的同學可以看看原始碼，再繼續深入學習，

以上就是本文的全部內容，如果覺得還不錯的話歡迎點贊，轉發和關注，感謝支持，

參考文章：

• https://github.com/golang/go/wiki/Well-known-struct-tags

推薦閱讀：

• 為什么 Go 不支持 []T 轉換為 []interface

標籤：其他

上一篇：02-VS除錯以及Qt基本使用

下一篇：Java并發基礎知識