yaml.marshal仅导出首字母大写的公开字段并转为小写蛇形，私有字段即使加yaml tag也无效；需用指针或marshalyaml控制零值输出，中文key须用map[interface{}]interface{}。
yaml.Marshal 为什么输出的字段全是小写？
因为 yaml.Marshal 默认只导出结构体中**首字母大写的公开字段**，且会把字段名转成小写蛇形（json 标签逻辑不同，它不自动转蛇形，但 yaml 包默认会）。这不是 bug，是设计行为。
- 确保结构体字段首字母大写，否则
yaml.Marshal完全忽略该字段 - 用
yamlstruct tag 显式控制字段名和是否忽略：yaml:"name,omitempty"、yaml:"age"、yaml:"-" - 如果字段是私有（小写开头），哪怕加了
yaml:"xxx"也无效 —— Go 反射拿不到私有字段值 - 嵌套结构体同理，每一层都要检查字段可见性
怎么让 int64、time.Time 这类类型输出更友好？
yaml.Marshal 对基础类型照单全收，但 int64 会输出完整数字（比如 1672531200000），time.Time 默认输出 Go 内部格式（如 2023-01-01 00:00:00 +0000 UTC），不符合 YAML 配置习惯。
- 对时间字段，推荐用自定义类型 +
MarshalYAML方法，返回string格式（如 RFC3339） - 对
int64等，若需语义化别名（如status_code: 200），直接用int更稳妥；非要int64就靠字段 tag 控制名称，值本身无法“美化” - 注意：不要试图在
MarshalYAML里返回map[string]interface{}来改结构 —— 容易引发无限递归
空字段和零值怎么控制是否输出？
默认情况下，yaml.Marshal 会输出所有非空字段，包括 0、""、false。想跳过零值，得靠 omitempty tag，但它有陷阱。
-
omitempty只对「零值」生效：0、""、nil、false，对指针类型的零值（nil）也有效 - 但它**不判断字段是否被显式赋值** —— 如果你写了
Age: 0，哪怕这是合法业务值，也会被删掉 - 解决办法：用指针类型（如
*int）或自定义类型 +MarshalYAML控制逻辑 - 切片为空（
[]string{}）会被当成零值删掉；但nil切片和空切片在 YAML 中语义不同，要注意区分
中文字段名或特殊 key 怎么保留？
YAML 规范允许任意字符串作 key，但 yaml.Marshal 默认只接受 struct field name 或 tag 指定的字符串，不能动态生成中文 key。真要这么做，得绕过 struct 直接构造 map[interface{}]interface{}。
- 结构体字段名必须是合法 Go 标识符，不能是中文；所以中文 key 只能走
map路线 - 示例：
m := map[interface{}]interface{}{"用户名": "张三", "创建时间": time.Now().Format("2006-01-02")}，再传给yaml.Marshal(m) - 注意：
map的 key 类型要是interface{}，且实际运行时最好统一为string，避免混用导致 panic - 这种写法失去结构体类型约束和编译期检查，适合配置生成等一次性场景，别用在高频序列化逻辑里
最常被忽略的是字段可见性与 omitempty 的组合效果 —— 看似加了 tag 就万事大吉，其实字段没导出，marshal 根本看不到它。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
