
go 的标准 json 包默认按结构体字段名序列化,但可通过实现 `marshaljson()` 方法,将结构体动态转为键值对形式的 json,使字段名(key)由运行时值决定。
在 Go 中,标准 encoding/json 包要求结构体字段名必须是固定标识符(如 Name、Value),无法直接生成形如 {"Country": "abc"} 这样键名来自变量值的 JSON。但这一限制可通过自定义序列化逻辑轻松突破:实现 json.Marshaler 接口的 MarshalJSON() 方法。
具体做法是,在结构体中定义所需数据字段(如 Name 和 Value),然后在 MarshalJSON() 中构造一个 map[string]interface{},以 Name 作为 map 的 key、Value 作为对应的 value,再调用 json.Marshal() 对该 map 进行序列化。
以下是完整可运行示例:
package main
import (
"encoding/json"
"fmt"
)
type xAxis struct {
Name string
Value string
}
// MarshalJSON 实现 json.Marshaler 接口
func (a xAxis) MarshalJSON() ([]byte, error) {
// 动态构建 key-value 映射:Name 作键,Value 作值
m := map[string]interface{}{a.Name: a.Value}
return json.Marshal(m)
}
func main() {
data := xAxis{
Name: "Country",
Value: "abc",
}
b, err := json.Marshal(data)
if err != nil {
panic(err)
}
fmt.Println(string(b)) // 输出:{"Country":"abc"}
}✅ 关键要点说明:
- MarshalJSON() 必须返回 ([]byte, error),且不能接收指针接收者(除非你明确需要修改原值;本例中使用值接收者更安全、语义清晰);
- 使用 map[string]interface{} 是最简洁的动态键方案,支持任意字符串作为 key;
- 若需支持 nil 值或嵌套结构,interface{} 可自然兼容(如 Value 为 nil、[]int 或另一结构体);
- ⚠️ 注意:反序列化(UnmarshalJSON)需同步实现 UnmarshalJSON() 方法才能完整支持双向转换,本例仅聚焦序列化场景;
- 此方法适用于配置映射、标签化指标、动态 API 响应等需“字段名即业务标识”的典型场景。
通过这一模式,你完全摆脱了静态结构体字段的约束,让 JSON 的 shape 真正由业务数据驱动。










