json.marshal 默认只序列化首字母大写的导出字段，私有字段被忽略；需用 struct tag 控制 key 名与行为，注意 time.time 和自定义类型须显式实现 marshaljson 或加 tag；写文件应先 marshal 再 os.writefile，避免文件句柄泄漏与编码问题。
json.Marshal 无法处理私有字段，得用首字母大写
Go 的 json.Marshal 默认只序列化导出（public）字段，也就是首字母大写的字段。如果结构体里全是小写字母开头的字段，生成的 JSON 就是空对象 {}，连错误都不会报。
- 确保结构体字段名首字母大写，例如
Name而不是name - 用 struct tag 显式控制 key 名和行为：
`json:"name,omitempty"`表示序列化时用小写name，且值为空时不输出该字段 - 不支持嵌套匿名字段自动展开；若嵌套结构体也需导出字段，否则内层字段被忽略
写入文件前必须检查 error，os.Create 容易被忽略返回值
os.Create 返回 *os.File 和 error，但很多人直接链式调用 json.NewEncoder(f).Encode(v)，一旦文件创建失败，后续操作 panic 或静默丢数据。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- 务必先判
err != nil，尤其在目录不存在或权限不足时，os.Create会返回no such file or directory - 写完记得
f.Close()——json.Encoder不自动关文件，漏掉会导致文件句柄泄漏、内容未 flush 到磁盘 - 更稳妥的做法是用
ioutil.WriteFile或os.WriteFile（Go 1.16+）：一步写入，无需手动管理文件句柄
time.Time 和自定义类型需要额外处理
默认情况下 time.Time 序列化为带时区的 RFC3339 字符串（如 "2024-05-22T14:30:00+08:00"），但如果你存的是 Unix 时间戳、毫秒数，或想统一用 UTC，就得干预。
- 给
time.Time字段加 tag：`json:"created_at,string"`可强制转成字符串格式（避免数值溢出） - 实现
MarshalJSON()方法来自定义序列化逻辑，比如输出毫秒时间戳：return json.Marshal(t.UnixMilli()) - 自定义类型（如枚举
type Status int）同理，必须实现MarshalJSON，否则按底层整型直出，无语义
中文乱码？别用 os.Stdout 直接打印 JSON
用 json.Marshal 得到的是 []byte，直接 fmt.Println 会把字节切片当整数列表打印；而写文件时若没指定 UTF-8 编码（其实 Go 默认就是 UTF-8），但编辑器可能误判编码——看起来像乱码。
- 调试时用
fmt.Printf("%s", b)或string(b)打印原始 JSON 字符串 - 写文件前可加 UTF-8 BOM（不推荐）或确认目标编辑器支持 UTF-8（VS Code、GoLand 默认 OK）
- 如果结构体含中文字符串，确保源码文件本身是 UTF-8 编码，否则字符串字面量就已损坏
json.MarshalIndent 格式化，再 os.WriteFile 一次性落地，中间不碰 *os.File。容易被忽略的是 time 和自定义类型的序列化契约——它们不会自动“懂你”，必须显式声明。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
