Golang怎么处理枚举值JSON序列化_Golang如何让iota枚举在JSON中显示为字符串名称【技巧】-Golang-PHP中文网

Go中iota枚举默认序列化为数字，需实现json.Marshaler和json.Unmarshaler接口才能输出字符串；必须用指针接收者实现UnmarshalJSON，配合双向映射表，并覆盖未知值测试。

golang怎么处理枚举值json序列化_golang如何让iota枚举在json中显示为字符串名称【技巧】

Go 的 `iota` 枚举默认序列化为数字，不是字符串名

Go 本身没有原生枚举类型，iota 只是常量生成器，定义出来的值本质是整数。所以直接用 json.Marshal 序列化结构体字段时，它只会输出数字，比如 0、1，而不是你期望的 "pending" 或 "done"。

让枚举在 JSON 中显示为字符串：必须实现 `json.Marshaler` 和 `json.Unmarshaler`

Go 的 encoding/json 包会自动调用类型实现的 MarshalJSON() 和 UnmarshalJSON() 方法。不实现，就走默认整数逻辑；实现了，才能控制输出格式。

常见错误现象：
– 字段值是 TaskStatus(0)，但 JSON 输出 {"status":0}，前端看不懂
– 实现了 MarshalJSON 却没实现 UnmarshalJSON，反序列化失败报 json: cannot unmarshal string into Go value of type TaskStatus

实操建议：

定义枚举类型为自定义命名类型，比如 type TaskStatus int，不能直接用 int
为该类型实现 func (s TaskStatus) MarshalJSON() ([]byte, error)，返回字符串字面量的 JSON 字节（注意加双引号）
同时实现 func (s *TaskStatus) UnmarshalJSON(data []byte) error，从字符串解析回对应值，失败时要返回具体错误（比如未知字符串）
所有枚举值需有对应字符串映射，建议用 map[TaskStatus]string 和 map[string]TaskStatus 两个查找表，避免 switch 冗长且易漏

示例关键片段：

type TaskStatus int

const (
	Pending TaskStatus = iota
	Done
	Cancelled
)

var taskStatusNames = map[TaskStatus]string{
	Pending:   "pending",
	Done:      "done",
	Cancelled: "cancelled",
}

var taskStatusValues = map[string]TaskStatus{
	"pending":   Pending,
	"done":      Done,
	"cancelled": Cancelled,
}

func (s TaskStatus) MarshalJSON() ([]byte, error) {
	if name, ok := taskStatusNames[s]; ok {
		return json.Marshal(name)
	}
	return nil, fmt.Errorf("unknown TaskStatus %d", s)
}

func (s *TaskStatus) UnmarshalJSON(data []byte) error {
	var name string
	if err := json.Unmarshal(data, &name); err != nil {
		return err
	}
	if v, ok := taskStatusValues[name]; ok {
		*s = v
		return nil
	}
	return fmt.Errorf("unknown TaskStatus name %q", name)
}