在go中，结构体字段名不能直接使用关键字（如type），但可通过json标签将导出字段映射为任意json键名，从而安全实现如"type"等保留字对应的字段序列化与反序列化。
在go中，结构体字段名不能直接使用关键字（如type），但可通过json标签将导出字段映射为任意json键名，从而安全实现如"type"等保留字对应的字段序列化与反序列化。
在开发API客户端时，经常需要将JSON响应直接解析为Go结构体。然而，当服务端返回的JSON字段名为Go语言保留关键字（例如 type）时，无法直接将其作为结构体字段名——因为Go不允许用关键字命名标识符，且非导出字段（小写首字母）也无法被encoding/json包访问。
正确做法是：使用导出字段（大写首字母）配合json结构体标签（struct tag）显式指定JSON键名。这样既满足Go语法规范，又确保JSON序列化/反序列化行为完全可控。
例如，针对如下JSON片段：
{
"cardId": "EX1_001",
"name": "Fireball",
"cardSet": "Expert",
"type": "Spell"
}应定义结构体如下：
立即学习“go语言免费学习笔记（深入）”；
type Card struct {
CardID string `json:"cardId"`
Name string `json:"name"`
CardSet string `json:"cardSet"`
Type string `json:"type"` // ✅ 映射到JSON中的 "type" 字段
}✅ 关键要点：
- 所有字段必须以大写字母开头（即导出），否则json.Unmarshal将忽略它们；
- json:"..." 标签精确控制JSON键名，支持大小写、下划线、驼峰甚至特殊字符（如json:"-"可忽略该字段）；
- 若需兼容空值或零值处理，可追加选项，例如json:"type,omitempty"（当Type == ""时不输出该字段）。
⚠️ 注意事项：
- 切勿尝试使用非导出字段（如type string）并依赖反射绕过导出限制——encoding/json明确要求字段可导出；
- 避免字段名与Go关键字同名（即使加了tag），这会导致编译错误；
- 在团队协作中，建议为字段添加清晰注释说明其对应JSON语义，例如：// Type corresponds to the "type" field in Blizzard's Hearthstone API。
通过这一模式，你既能严格遵循Go语言规范，又能灵活适配任意外部API的JSON schema，是构建健壮API客户端的标准实践。
