在 Go 語言中，struct 是一種復(fù)合數(shù)據(jù)類型，用于將多個(gè)不同類型的數(shù)據(jù)組合成一個(gè)單一的數(shù)據(jù)單元。通過使用 struct，可以定義復(fù)雜的數(shù)據(jù)結(jié)構(gòu)，便于組織和管理數(shù)據(jù)。struct 是 Go 語言中非常重要的一個(gè)概念，廣泛應(yīng)用于數(shù)據(jù)建模、對象表示、數(shù)據(jù)傳輸?shù)葓鼍啊?/p>

在 Go 語言中，結(jié)構(gòu)體字段標(biāo)簽（Struct Tag） 是一種用于給字段添加元信息（metadata）的機(jī)制，常用于序列化（如 JSON、XML）、ORM 映射、驗(yàn)證等場景。你在開發(fā) Web 應(yīng)用或處理數(shù)據(jù)交互時(shí)，一定會(huì)經(jīng)?？吹筋愃葡旅娴膶懛ǎ?/p>

type User struct {
	Username string `json:"username"`
	Token    string `json:"token"`
}

其中的 json:"token" 就是字段標(biāo)簽，它并不影響 Go 語言本身的語法邏輯，但它在使用反射（reflect）時(shí)非常有用，特別是當(dāng)你用標(biāo)準(zhǔn)庫如 encoding/json 時(shí)。

一、結(jié)構(gòu)體標(biāo)簽的基本語法

結(jié)構(gòu)體標(biāo)簽是一對反引號 ` 包起來的字符串，里面是一個(gè)鍵值對的形式：

FieldName FieldType `key:"value"`
//可以寫多個(gè)鍵值對：
FieldName FieldType `json:"token" xml:"token" validate:"required"`

這些標(biāo)簽是給其他包（通常是庫）解析使用的，不影響 Go 編譯器的行為。

二、json:"token"的具體含義

當(dāng)你用 encoding/json 包將結(jié)構(gòu)體編碼為 JSON 時(shí)，這個(gè)標(biāo)簽的作用是：
? 指定序列化后的字段名
默認(rèn)情況下，Go 會(huì)使用結(jié)構(gòu)體字段名作為 JSON 的字段名。但注意：
Go 結(jié)構(gòu)體的字段是大寫開頭（導(dǎo)出）；
JSON 通常用小寫字段名（如 “token”）；
為了統(tǒng)一后端返回格式并滿足前端規(guī)范，我們可以顯式指定字段名：

type User struct {
	Token string `json:"token"`
}

生成的json:

{
  "token": "abc123"
}

? 反序列化時(shí)也生效
當(dāng)你將 JSON 反序列化成結(jié)構(gòu)體時(shí)，Go 會(huì)根據(jù)標(biāo)簽來找對應(yīng)字段。例如上面的json格式能成功映射到：

var user User
json.Unmarshal(data, &user)
// user.Token == "abc123"

三、常見的標(biāo)簽格式變體

type User struct {
	Token string `json:"token"`           // 顯式指定字段名為 token
	Age   int    `json:"-"`               // 忽略該字段，不進(jìn)行序列化
	Email string `json:"email,omitempty"` // 若為空則忽略該字段
}

json:“-”: 表示這個(gè)字段永遠(yuǎn)不會(huì)被編碼或解碼，即不導(dǎo)出。
json:“email,omitempty”: 表示只有字段不為默認(rèn)值時(shí)，才會(huì)被編碼到 JSON（比如字符串為 “”，數(shù)字為 0 就會(huì)忽略）。

四、使用示例

package main
import (
	"encoding/json"
	"fmt"
)
type User struct {
	Username string `json:"username"`
	Token    string `json:"token"`
	Age      int    `json:"-"` // 不導(dǎo)出
}
func main() {
	user := User{
		Username: "Alice",
		Token:    "abc123",
		Age:      30,
	}
	data, _ := json.Marshal(user)
	fmt.Println(string(data))
}
//{"username":"Alice","token":"abc123"}

五、使用建議

• 字段必須導(dǎo)出（首字母大寫），否則即使有 tag，json 包也不會(huì)訪問它。
• 推薦統(tǒng)一使用小寫 JSON 字段名：json:“username”，更符合前端 JSON 風(fēng)格。
• 如有嵌套結(jié)構(gòu)體，注意為子結(jié)構(gòu)體也添加 json 標(biāo)簽。!!!~~~~~~~~!!! 務(wù)必都為添加 json 標(biāo)簽的結(jié)構(gòu)體?。。?！不然前端解析不了?。。?/li>

疑問？ 如果json tag為"-" ，為什么不把結(jié)構(gòu)體首字母小寫呢 不是一個(gè)效果嗎？

?json:"-"的用途
json:“-” 是明確告訴 encoding/json：“這個(gè)字段你不要處理，序列化/反序列化時(shí)忽略它”。這在結(jié)構(gòu)體對外暴露字段但不希望被 JSON 處理時(shí)非常有用，比如：

type User struct {
	Username string `json:"username"`
	Password string `json:"-"` // 不想被輸出！
}

你仍然可以在后端處理 Password 字段，但它不會(huì)出現(xiàn)在 JSON 輸出中。這是安全和結(jié)構(gòu)清晰性方面的明確表達(dá)。
? 總結(jié)：選擇建議

簡單例子：

type RespMsg struct {
	Code int         `json:"code"`
	Msg  string      `json:"msg"`
	Data interface{} `json:"data"`
}
type LoginData struct {
	Token    string `json:"token"`
	Username string `json:"username"`
	Location string `json:"location"`
}
rsp := RespMsg{
	Code: 200,
	Msg:  "success",
	Data: LoginData{
		Token:    userToken,
		Username: username,
		Location: "/static/view/home.html",
	},
}

這樣返回的 JSON 就是：

{
  "code": 200,
  "msg": "success",
  "data": {
    "token": "...",
    "username": "...",
    "location": "..."
  }
}

前端用 resp.data.token、resp.data.username 就不會(huì)有大小寫錯(cuò)位的問題。

到此這篇關(guān)于Go 語言中的 Struct Tag 的用法詳解的文章就介紹到這了,更多相關(guān)Go Struct Tag 用法內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評論