本文详解如何将 json 字符串中的数组字段（如 jobs）安全解码为 go 结构体指针切片，并将其追加到已有结构体中，最终通过 html 模板正确渲染嵌套数据。
本文详解如何将 json 字符串中的数组字段（如 jobs）安全解码为 go 结构体指针切片，并将其追加到已有结构体中，最终通过 html 模板正确渲染嵌套数据。
在 Go Web 开发与模板渲染实践中，常需将外部 JSON 数据（如 API 响应）动态合并进已定义的业务结构体中，再交由 html/template 渲染。但若直接使用 map[string]interface{} 解析含嵌套数组的 JSON，会导致类型丢失，无法与结构体字段（如 []*Job）自然对接，从而引发模板渲染失败或空值问题。
核心解决思路是：避免泛型 map[string]interface{}，改用带明确字段类型的匿名或命名结构体进行 JSON 反序列化，确保类型安全与字段对齐。
以下为修正后的完整实现：
package main
import (
"fmt"
"html/template"
"os"
"encoding/json"
)
type Person struct {
Name string
Jobs []*Job
}
type Job struct {
Employer string `json:"Employer"`
Role string `json:"Role"`
}
const templ = `The name is {{.Name}}.
{{with .Jobs}}
{{range .}}
An employer is {{.Employer}}
and the role is {{.Role}}
{{end}}
{{end}}
`
func main() {
job1 := Job{Employer: "Monash", Role: "Honorary"}
job2 := Job{Employer: "Box Hill", Role: "Head of HE"}
// 原始 JSON 数据（注意：字段名需与结构体 tag 匹配）
byt := []byte(`{"num":6.13,"Jobs":[{"Employer":"test1","Role":"test1"},{"Employer":"test2","Role":"test2"}]}`)
// ✅ 正确做法：定义临时结构体，精确匹配 JSON 结构
var jsonData struct {
Jobs []*Job `json:"Jobs"`
}
if err := json.Unmarshal(byt, &jsonData); err != nil {
panic(err)
}
// 创建 Person 实例，初始包含部分 Job
person := Person{
Name: "jan",
Jobs: []*Job{&job1, &job2},
}
// ✅ 将 JSON 解析出的 Jobs 追加到 person.Jobs 切片
person.Jobs = append(person.Jobs, jsonData.Jobs...)
// 渲染模板
t := template.Must(template.New("Person template").Parse(templ))
if err := t.Execute(os.Stdout, person); err != nil {
checkError(err)
}
}
func checkError(err error) {
if err != nil {
fmt.Println("Fatal error:", err.Error())
os.Exit(1)
}
}? 关键要点说明：
- 结构体字段标签（json:"Employer"）必须与 JSON 键名严格一致，否则反序列化失败；
- 使用 append(dst, src...) 时，... 是必需语法糖，用于将切片展开为可变参数；
- template.Must() 替代手动 Parse + checkError，提升代码简洁性与健壮性；
- 若 JSON 中存在 person 全量数据（含 Name 和 Jobs），可直接定义完整结构体（如 type PersonJSON Person）并统一解析，无需手动拼接。
此方案兼顾类型安全、可读性与工程实践，适用于配置加载、API 数据聚合、模板预填充等典型场景。
