go 的 json 包默认忽略非导出（小写首字母）字段，但通过自定义 marshaljson 和 unmarshaljson 方法，可显式控制所有字段的 json 编解码行为，无需暴露内部字段。
在 Go 中，encoding/json 包仅能访问结构体的导出字段（即首字母大写的字段），因此像 fieldA string 这样的非导出字段默认不会参与 JSON 序列化。若需同时处理导出与非导出字段，不能依赖嵌入原结构体的方式递归调用 json.Marshal（如 *Test 嵌入会导致无限递归），而应采用「中间结构体（DTO）」策略：定义一个纯导出字段的辅助结构体，作为 JSON 编解码的桥梁。
以下是一个清晰、安全且可维护的实现方案：
type Test struct {
fieldA string // 非导出，仅内部使用
FieldB int // 导出，可被 json 默认处理，但此处统一由自定义逻辑控制
FieldC string // 导出
}
// TestJSON 是专用于 JSON 传输的导出结构体，字段全部大写且带 json 标签
type TestJSON struct {
FieldA string `json:"fieldA"`
FieldB int `json:"fieldB"`
FieldC string `json:"fieldC"`
}
func (t *Test) MarshalJSON() ([]byte, error) {
return json.Marshal(TestJSON{
FieldA: t.fieldA,
FieldB: t.FieldB,
FieldC: t.FieldC,
})
}
func (t *Test) UnmarshalJSON(b []byte) error {
var temp TestJSON
if err := json.Unmarshal(b, &temp); err != nil {
return err
}
// 显式赋值回原结构体，保持封装性
t.fieldA = temp.FieldA
t.FieldB = temp.FieldB
t.FieldC = temp.FieldC
return nil
}✅ 优势说明：
- 无递归风险：不嵌入 *Test，彻底避免 MarshalJSON 自调用导致的栈溢出；
- 类型安全：TestJSON 是独立结构体，字段名与标签明确，修改 Test 字段时只需同步更新 TestJSON 和编解码逻辑，IDE 可精准提示；
- 封装性完好：fieldA 仍为非导出字段，外部包无法直接访问，仅通过 JSON 接口可控暴露；
- 扩展友好：新增字段时，只需在 TestJSON 中添加对应字段及 MarshalJSON/UnmarshalJSON 中的赋值语句，逻辑集中、不易遗漏。
⚠️ 注意事项：
- UnmarshalJSON 中必须使用 &temp（取地址）传递指针给 json.Unmarshal，否则解码无效；
- 若 Test 包含嵌套结构体或需要深度复制的字段（如切片、map），应在 UnmarshalJSON 中进行深拷贝，避免外部修改影响内部状态；
- 不建议为简单场景强行保留非导出字段——若 fieldA 本质是公共数据，直接导出（FieldA）并利用 json 标签更简洁；本方案适用于确有封装需求（如字段需校验、惰性加载或权限控制）的场景。
总之，中间结构体法是 Go 中平衡封装性与序列化灵活性的标准实践，比手动拼接 JSON 字符串或反射更安全、比全字段导出更严谨。
