go 中结构体字段首字母小写导致 `json.marshal` 返回空对象，根本原因是未导出字段无法被 `encoding/json` 包访问；只需将字段名首字母大写并保持 json tag 正确即可解决。
在 Go 语言中，encoding/json 包仅能访问导出（exported）字段——即首字母大写的字段。若结构体字段为小写（如 pods、name），即使添加了 json:"xxx" 标签，json.Marshal 仍会忽略这些字段，最终生成空 JSON 对象（如 {}），这是初学者最常见的序列化失败原因。
以下为修复前后的关键对比：
❌ 错误示例（字段未导出）：
type PodsCondensed struct {
pods []PodCondensed `json:"pods"` // 小写 pods → 未导出 → 被忽略
}
type PodCondensed struct {
name string `json:"name"` // 小写 name → 未导出
colors []string `json:"colors"` // 小写 colors → 未导出
}
运行后 json.Marshal(fake_pods) 输出始终为 {}，尽管 fmt.Println(fake_pods.pods) 能正常打印内部数据。
✅ 正确写法（字段导出 + tag 显式声明）：
Node.js 可靠编程
下载
Node.js 可靠编程技能。避免事件循环阻塞、异步陷阱、ESM 兼容问题和内存泄漏。触发词：Node.js 开发、async/await、流处理、性能优化、安全编码。
type PodsCondensed struct {
Pods []PodCondensed `json:"pods"` // 首字母大写，可导出
}
func (p *PodsCondensed) AddPod(pod PodCondensed) {
p.Pods = append(p.Pods, pod) // 注意：同步更新导出字段名
}
type PodCondensed struct {
Name string `json:"name"` // 导出字段
Colors []string `json:"colors"` // 导出字段
}
完整可运行示例：
package main
import (
"encoding/json"
"fmt"
)
type PodsCondensed struct {
Pods []PodCondensed `json:"pods"`
}
func (p *PodsCondensed) AddPod(pod PodCondensed) {
p.Pods = append(p.Pods, pod)
}
type PodCondensed struct {
Name string `json:"name"`
Colors []string `json:"colors"`
}
func main() {
fake_pods := PodsCondensed{}
fake_pod := PodCondensed{
Name: "tier2",
Colors: []string{"blue", "green"},
}
fake_pods.AddPod(fake_pod)
fmt.Printf("Go value: %+v\n", fake_pods.Pods) // [{Name:"tier2" Colors:["blue" "green"]}]
jPods, err := json.Marshal(fake_pods)
if err != nil {
panic(err)
}
fmt.Printf("JSON output: %s\n", string(jPods)) // {"pods":[{"name":"tier2","colors":["blue","green"]}]
}
注意事项：
- 字段导出性（首字母大小写）优先级高于 JSON tag；tag 仅控制键名，不解决可见性问题；
- 方法接收者（如 func (p *PodsCondensed) AddPod(...)）中的字段访问也需使用导出字段名（如 p.Pods）；
- 若需保留字段私有性但又支持 JSON 序列化，可添加 getter 方法并配合自定义 MarshalJSON()，但对简单场景过度设计，推荐直接导出字段；
- 使用 json:",omitempty" 可在值为空时省略字段，但不改变导出要求。
总结：Go 的反射机制严格遵循导出规则，encoding/json 也不例外。确保结构体字段首字母大写，是 JSON 序列化的前提条件——这不是 bug，而是 Go 明确的设计哲学：封装靠命名，而非语法修饰符。
