c.XML()是唯一安全的XML响应方式，它底层调用encoding/xml自动处理转义、序列化及nil字段；struct需显式声明xml tag控制节点名与属性，map会生成固定<map>根节点，生产环境应使用自定义struct确保符合XML Schema规范。
c.XML() 是唯一安全的 XML 响应方式
别用 c.String() 拼接 XML 字符串，也别手动设 Content-Type: application/xml。那样既不转义 &、、<code>>，又没法处理 nil 字段、切片嵌套或属性声明——XML 一解析就报错或丢数据。Gin 的 c.XML() 底层调用 encoding/xml，自动做转义、序列化和空值判断，这才是唯一可信赖的出口。
常见错误现象：c.String(200, "<user><name>Alice & Bob</name></user>") 返回的 XML 在浏览器或客户端里会被解析成 <user><name>Alice & Bob</name></user>（如果没转义）或直接截断（如果含未闭合标签）；而 c.XML() 会把 & 自动变成 &，保证结构合法。
- 必须用
c.XML(code, data)，参数data类型可以是 struct 或 map，但推荐 struct - 状态码建议用
http.StatusOK而非硬写200，便于维护 - 不要在
c.XML()之后再调用c.Status()或c.Header()，它已内部设置好状态码和头
struct 必须加 xml tag，否则字段名直接暴露为节点名
Go struct 导出字段默认映射为同名 XML 节点，比如 Name string → <name>xxx</name>。这既不符合 XML 小写短横线惯例（如 user-name），也不兼容已有 Schema。所有字段都得显式声明 xml tag。
使用场景：生成 RSS、Sitemap、企业内部 SOAP 接口等需要严格命名规范的 XML。
立即学习“go语言免费学习笔记（深入）”；
-
Name string <code>xml:"user_name"→<user_name>xxx</user_name> -
Age int <code>xml:"age,attr"→ 作为属性：<user age="25">...</user> -
Tags []string <code>xml:"tag>chardata"→ 每个字符串单独渲染为<tag>go</tag><tag>gin</tag> - 字段为
*string且值为nil时，默认不输出该节点；若需空标签（如<phone></phone>），加xml:",omitempty"不起作用，得用指针 + 非空判断逻辑
map 渲染根节点固定为 <map>，生产环境禁用
用 gin.H{"name": "alice", "age": 25} 调 c.XML()，结果一定是 <map><name>alice</name><age>25</age></map>。这个 <map> 根节点无法控制，也无法满足 <rss>、<urlset> 等标准格式要求。
性能影响不大，但语义错误严重——下游系统按约定根节点解析，拿到 <map> 直接拒收。
- 强制用自定义 struct，通过类型名控制根节点：
type Sitemap struct { XMLName xml.Name <code>xml:"urlset"; URLs []URLxml:"url"} -
XMLName字段必须存在且 tag 为xml:"xxx"，才能覆盖默认根名 - 避免在 handler 里临时构造 map 再传给
c.XML()，尤其当接口契约明确时
切片渲染易错：同名节点 vs 合并内容
XML 没有原生数组概念，encoding/xml 把切片展开为多个同名节点。比如 Users []User <code>xml:"user" → <user>...</user><user>...</user>。但如果你想要的是 <tags>go,gin,xml</tags> 这种单节点多值形式，就不能直接传切片。
容易踩的坑：把 []string 直接塞进 struct 字段，期望它自动 join 成逗号分隔字符串——它不会，只会生成一堆同名节点。
- 要多个同名子节点：用切片 + 正确 tag，如
Roles []string <code>xml:"role" - 要单节点含合并内容：先
strings.Join(tags, ",")，再赋给 string 字段，如TagList string <code>xml:"tags" - 嵌套 struct 切片时，确保每层 struct 都有
xmltag，否则内层字段可能被忽略或错位 - 空切片（
[]User{}）渲染结果是零个<user></user>节点，不是<user></user>，这点和 JSON 不同
XML 渲染真正麻烦的不是语法，而是 schema 对齐——字段名、层级、属性、空值策略都得和下游系统逐条对齐。用 struct + xml tag 是唯一可控路径，map 和手动拼接只适合调试或原型验证。
