Go 中嵌套结构体无法序列化为 JSON 的原因及解决方案_网络技术

Go 中嵌套结构体无法序列化为 JSON 的原因及解决方案

发布时间 - 2025-12-26 00:00:00 点击率：次

go 的 `json.marshal` 只能序列化导出（首字母大写）的结构体字段，小写开头的字段默认不可见，导致序列化结果为空对象 `{}`。

在 Go 语言中，JSON 序列化依赖于反射机制，而反射仅能访问 已导出（exported）字段——即字段名首字母必须为大写。你提供的代码中，Configitem 和 GuiConfig 的所有字段均以小写字母开头（如 local_address、configs），因此 encoding/json 包在序列化时完全忽略它们，最终输出空 JSON 对象 {}。

✅ 正确做法：将结构体字段改为导出字段（首字母大写），并推荐添加 JSON 标签以控制键名：

type Configitem struct {
    LocalAddress string `json:"local_address"`
    LocalPort    int    `json:"local_port"`
    Method       string `json:"method"`
    Password     string `json:"password"`
    Server       string `json:"server"`
    ServerPort   string `json:"server_port"`
    Timeout      int    `json:"timeout"`
}

type GuiConfig struct {
    Configs []*Configitem `json:"configs"`
    Index   int           `json:"index"`
}

修改后完整可运行示例：

package main

import (
    "encoding/json"
    "fmt"
)

type Configitem struct {
    LocalAddress string `json:"local_address"`
    LocalPort    int    `json:"local_port"`
    Method       string `json:"method"`
    Password     string `json:"password"`
    Server       string `json:"server"`
    ServerPort   string `json:"server_port"`
    Timeout      int    `json:"timeout"`
}

type GuiConfig struct {
    Configs []*Configitem `json:"configs"`
    Index   int           `json:"index"`
}

func main() {
    item1 := &Configitem{
        LocalAddress: "eouoeu",
        LocalPort:    111,
        Method:       "eoeoue",
        Password:     "ouoeu",
        Server:       "oeuoeu",
        ServerPort:   "qoeueo",
        Timeout:      3333,
    }

    config1 := &GuiConfig{
        Index:   1,
        Configs: []*Configitem{item1},
    }

    data, err := json.Marshal(config1)
    if err != nil {
        panic(err)
    }
    fmt.Println(string(data))
    // 输出：{"configs":[{"local_address":"eouoeu","local_port":111,"method":"eoeoue","password":"ouoeu","server":"oeuoeu","server_port":"qoeueo","timeout":3333}],"index":1}
}

⚠️ 注意事项：

即使字段导出，若类型不支持 JSON 编码（如 func、chan、未导出结构体等），仍会报错或跳过；
若需保留小写字段名但又不想导出（如封装敏感逻辑），可手动实现 json.Marshaler 接口，自定义序列化逻辑；
JSON 标签中的 - 表示忽略该字段；omitempty 可在值为空时省略字段（如 json:"name,omitempty"）；
嵌套结构体同样需满足导出规则——子结构体本身类型名也须首字母大写（如 Configitem ✅，configitem ❌）。

总结：Go 的 JSON 序列化严格遵循包可见性规则。“小写 = 私有 = 不可序列化” 是初学者常见陷阱。养成结构体字段首字母大写 + 显式 JSON 标签的习惯，是编写健壮序列化逻辑的基础。

# word # js # git # json # go # 编码 # ai # igs # 封装 # 结构体 # 接口 # 对象 # 序列化 # 首字母 # 字段名 # 可在 # 自定义 # 不支持 # 但又 # 报错 # 仅能 # 跳过

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：ubuntu vnc如何卸载残留

下一篇：nodejs中解决异步嵌套循环和循环嵌套异步的问题

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：ubuntu vnc如何卸载残留

下一篇：nodejs中解决异步嵌套循环和循环嵌套异步的问题