gin 的 c.yaml() 可直接返回 yaml 内容，内部已依赖 gopkg.in/yaml.v2，无需显式 import；但解析 yaml 文件需手动引入该包。它默认设 content-type 为 application/x-yaml，字段名优先匹配 yaml: 标签，fallback 到 json: 标签，不支持循环引用和 time.time 格式化。
Gin 直接用 c.YAML() 返回 YAML 内容是可行的，但默认不支持嵌套结构体字段名自定义、空值处理或时间格式控制——这些得靠结构体标签和底层 gopkg.in/yaml.v2 的行为决定，不是 Gin 本身能改的。
YAML 响应必须引入 yaml 包吗？
不需要显式 import，c.YAML() 内部已依赖 gopkg.in/yaml.v2；但如果你要解析配置文件（比如读 config.yaml），就得手动加这行：
import "gopkg.in/yaml.v2"
否则编译会报 undefined: yaml 错误。Gin 的 c.YAML() 只负责序列化输出，不负责读取。
结构体字段名不生效？检查 json 标签是否干扰
c.YAML() 实际调用的是 yaml.Marshal()，它优先识别 yaml: 标签， fallback 到 json: 标签，最后才用字段名。常见坑：
- 写了
json:"user"但没写yaml:"user"，YAML 输出仍是大驼峰字段名（如UserName） - 字段是私有（小写开头），即使有
yaml:"user"也不会被导出——Go 规则，首字母必须大写 -
omitempty在 YAML 里也生效，但对零值（""、0、nil）的判定和 JSON 一致
正确写法示例：
type User struct {
Name string `yaml:"user" json:"user"`
Email string `yaml:"email" json:"email"`
Age int `yaml:"age" json:"age"`
}
返回 map 或 gin.H 时字段顺序混乱
gin.H 是 map[string]interface{}，Go 中 map 迭代无序，YAML 渲染出来的键顺序每次可能不同。如果需要固定顺序（比如配置文件展示场景）：
- 不用
gin.H，改用结构体 + 显式字段声明 - 或用
map[string]interface{}但配合yaml.MapSlice（需额外 importgopkg.in/yaml.v2）
简单起见，日常 API 响应不用强求顺序；但如果是返回类似 config.yaml 的可读配置内容，结构体更可靠。
Content-Type 是 text/yaml 吗？
不是。c.YAML() 默认设的是 application/x-yaml，不是标准的 text/yaml 或 application/yaml。浏览器可能不自动格式化显示，curl 看是纯文本，但语义上没问题。如果下游系统严格校验 MIME 类型，可以手动覆盖：
c.Header("Content-Type", "text/yaml; charset=utf-8")
c.YAML(http.StatusOK, data)
注意：先调 c.Header()，再调 c.YAML()，否则会被覆盖。
真正容易被忽略的是：YAML 输出不支持循环引用，也不处理 time.Time 的格式化——它直接调用 fmt.Sprintf("%v")，结果是类似 2006-01-02 15:04:05.999999999 -0700 MST 的长字符串。需要可控时间格式，得提前转成字符串字段。
