本文介绍在 Go 中将已有结构体实例嵌套进包装结构体，以生成包含嵌套字段（如 "fields"）和附加元数据（如 "meta"）的 JSON 输出，重点讲解结构体组合、字段导出规则及 JSON 标签控制。
本文介绍在 go 中将已有结构体实例嵌套进包装结构体，以生成包含嵌套字段（如 `"fields"`）和附加元数据（如 `"meta"`）的 json 输出，重点讲解结构体组合、字段导出规则及 json 标签控制。
在 Go 中实现结构体嵌套 JSON 序列化，关键在于正确设计包装结构体并确保字段可被 JSON 包装器访问。原始结构体 my_struct 的字段首字母小写（如 First），虽可通过 json 标签映射为小写键（"first"），但其本身是非导出字段——这意味着若直接嵌入到另一个结构体中且未导出，json.Marshal 将完全忽略它。
因此，最简洁、符合 Go 惯例的方案是：定义一个导出的包装结构体，其中包含导出的嵌套字段，并显式指定 JSON 键名。以下是完整示例：
package main
import (
"encoding/json"
"fmt"
)
type MyStruct struct { // 首字母大写：导出类型，必要！
First string `json:"first"`
Second string `json:"second"`
Number int `json:"number"`
}
type WrappedOutput struct {
Fields MyStruct `json:"fields"` // 导出字段 + 明确标签
Meta string `json:"meta"`
}
func main() {
output := MyStruct{
First: "my_string",
Second: "another_string",
Number: 2,
}
wrapped := WrappedOutput{
Fields: output,
Meta: "data",
}
data, err := json.MarshalIndent(wrapped, "", " ")
if err != nil {
panic(err)
}
fmt.Println(string(data))
}
输出结果（格式化后）：
{
"fields": {
"first": "my_string",
"second": "another_string",
"number": 2
},
"meta": "data"
}
✅ 关键要点说明：
-
结构体与字段必须导出：Go 的
json包仅序列化首字母大写的导出字段。my_struct→MyStruct，fields→Fields。 -
使用
json:"fields"显式控制键名：避免默认驼峰转蛇形或大小写问题。 - 无需反射或手动 map 构造：结构体组合天然支持嵌套，语义清晰、性能高效、类型安全。
-
json.MarshalIndent提升可读性：开发调试时推荐使用，生产环境可用json.Marshal。
⚠️ 注意事项：
- 若原始结构体无法修改（如来自第三方包），可改用匿名结构体或
map[string]interface{}，但会牺牲类型安全； - 嵌套字段若为指针（如
*MyStruct），需确保非 nil，否则序列化为null； - 如需动态字段名或运行时决定嵌套逻辑，应考虑
map[string]interface{}或自定义MarshalJSON方法——但本场景中结构化包装体是更优解。
综上，通过导出型包装结构体组合，即可优雅、高效地实现结构体嵌套 JSON 输出，这是 Go 中处理此类需求的标准实践。
