本文详解 go 语言中构建可正确 json 序列化的结构体，指出常见类型定义错误（如非法字段名、未导出字段、自定义 map 类型导致的序列化失败），并提供符合 go 编码规范的简洁实现方案。
本文详解 go 语言中构建可正确 json 序列化的结构体，指出常见类型定义错误（如非法字段名、未导出字段、自定义 map 类型导致的序列化失败），并提供符合 go 编码规范的简洁实现方案。
在 Go 中生成有效的 JSON 输出，关键在于结构体字段的可见性、命名规范及类型的 JSON 可序列化性。原始代码存在多个根本性问题，导致 json.MarshalIndent 无法输出预期的数组：
❌ 原代码主要问题分析：
-
字段未导出：
Veggies和array字段首字母小写（veggies,array），Go 的 JSON 包只会序列化首字母大写的导出字段； -
非法类型别名：
type array map[string][]int定义了非结构体类型别名，但json包对未导出字段或非标准复合类型的处理受限，且该类型本身未导出（小写array），无法被json包访问； -
语法错误：
vegetables["Carrots"] = 21中Vegetables{}未定义为map类型（应为map[string]int），且n["array"] = [...]写法缺少类型声明与初始化； -
命名冲突风险：使用
array作为类型名易与语言概念混淆，且不符合 Go 的命名惯例（推荐Ints,Items等语义化名称）。
✅ 正确做法：使用导出字段 + 标准 Go 类型
package main
import (
"encoding/json"
"fmt"
)
type Data struct {
Veggies map[string]int `json:"veggies"` // 导出字段，可序列化；可加 tag 控制 key 名
Ints []int `json:"ints"` // 切片天然支持 JSON 数组
}
func main() {
// 初始化 map
veggies := make(map[string]int)
veggies["Carrots"] = 21
veggies["Broccoli"] = 15
// 初始化切片（JSON 数组）
ints := []int{1, 1, 1}
d := Data{
Veggies: veggies,
Ints: ints,
}
b, err := json.MarshalIndent(d, "", " ")
if err != nil {
panic(err)
}
fmt.Println(string(b))
}输出结果：
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
{
"veggies": {
"Broccoli": 15,
"Carrots": 21
},
"ints": [1, 1, 1]
}? 关键要点总结：
- ✅ 所有需 JSON 序列化的字段必须首字母大写（导出）；
- ✅ 优先使用内置类型：
map[string]int、[]int、[]string等，避免无必要的自定义类型封装； - ✅ 善用 JSON tag（如
`json:"veggies"`）控制输出字段名，提升 API 兼容性； - ⚠️
json包忽略未导出字段、函数、channel、不支持的类型（如func()、unsafe.Pointer）； - ? 推荐精读官方文档：https://www.php.cn/link/c69dc1d8a3a3b79d0de6fbedb4cb80a7，并结合《Go 程序设计语言》（Gopl.io）系统学习类型、反射与序列化机制。
遵循以上原则，即可稳定、清晰地生成符合标准的 JSON 数据，避免“看不见的数组”这类静默失败问题。
