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

go 的 `json.marshal` 只能序列化首字母大写的导出字段，小写开头的结构体字段（如 `local_address`）属于未导出成员，会被忽略，导致输出空对象 `{}`。解决方法是将字段名首字母大写并添加 json 标签，或自定义 `marshaljson` 方法。

在 Go 语言中，JSON 序列化依赖于 字段的可见性（exported/unexported），而非字段是否被显式标记。encoding/json 包运行在独立包内，它无法访问非导出（即小写开头）的结构体字段——这是 Go 的基础封装机制决定的。因此，原始代码中所有字段（如 local_address, local_port 等）均为小写开头，json.Marshal 对它们“视而不见”，最终只得到一个空 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}
}

⚠️ 注意事项：

字段名必须以大写字母开头（如 LocalAddress），否则即使加了 json 标签也无效；
json 标签中的值（如 "local_address"）定义了 JSON 输出的键名，支持别名、忽略（"-"）和条件省略（",omitempty"）；
若因设计需要保留字段私有性（不导出），可实现 MarshalJSON() ([]byte, error) 方法来自定义序列化逻辑，但会增加维护成本，一般不推荐；
嵌套结构体同理：所有层级中参与 JSON 序列化的字段都必须是导出字段。

总结：Go 的 JSON 序列化严格遵循“导出即可见”原则。养成首字母大写 + 显式 json 标签的习惯，是编写健壮、可维护序列化代码的关键实践。

# word # js # git # json # go # ai # 解决方法 # igs # 封装 # Error # 结构体 # 对象 # 序列化 # 首字母 # 字段名 # 自定义 # 这是 # 键名 # 均为 # 而非 # 视而不见

返回目录在线咨询

上一篇：多区域部署网站服务器的优势：提升全球访问速度
下一篇：docker 如何搭建私有仓库（ubuntu 14.04,Docker版本1.6.4）详细介绍

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

全网整合营销服务商

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

您的项目需求