Xcode 无内置XML转Swift Struct功能，因XMLParser仅提供事件回调，需手动处理状态与嵌套；易致nil值、属性丢失、命名冲突；推荐XMLMapper手动建模或XMLCoder配合namespace配置。
XML 转 Swift Struct 为什么不能靠 Xcode 自带功能
Xcode 没有内置 XML 解析器生成 Swift Struct 的能力，XMLParser 是事件驱动的流式解析器，它不自动生成模型，只提供 parser(_:didStartElement:namespaceURI:qualifiedName:attributes:) 这类回调。你得自己维护状态、拼字段、处理嵌套——直接手写容易漏掉 attributes 或搞错层级关系。
常见错误现象：nil 值泛滥、数组嵌套丢失、属性名被忽略（比如 <item id="123"></item> 中的 id 没进 Struct）、命名冲突（class、type 等关键字没转义）。
实操建议：
- 别用纯正则或字符串替换——XML 有 CDATA、命名空间、实体编码（如
<），正则会崩 - 优先选支持
XMLSchema或 DTD 推断结构的工具，而非仅靠示例 XML“猜”类型 - 如果 XML 来源固定且稳定，手动写
Codable+XMLParserDelegate更可控；若需频繁更新模型，再上代码生成工具
推荐用 XMLMapper 配合 XMLParser 手动建模
XMLMapper 不是代码生成器，而是一个轻量映射库，它让你用类似 JSONDecoder 的方式写 Swift Struct，再通过协议约定如何从 XML 节点提取值。比硬写 delegate 清晰，又比全自动工具少踩坑。
使用场景：iOS 工程已用 Codable，想复用命名习惯和可选性逻辑，同时保留对 attribute / text / nested element 的显式控制。
实操建议：
- Struct 必须遵守
XMLMappable协议，实现init(xmlMap: XMLMap) - 用
xmlMap.map显式绑定：比如xmlMap.map("title", to: &title)提取文本，xmlMap.mapAttribute("id", to: &id)提取属性 - 嵌套对象要额外声明
xmlMap.map("author", to: &author)，不能靠自动推导 - 数组字段必须用
xmlMap.array，否则只会拿到最后一个子节点
生成工具选 swift-xml-coder 还是 XMLCoder
XMLCoder 是主流选择，基于 Encoder/Decoder 协议，兼容 Codable，但默认不支持 attributes——必须加 @XMLAttribute 或 @XMLText 等 wrapper 类型。而 swift-xml-coder 是旧项目，已停止维护，Swift 5.5+ 下编译失败率高。
参数差异明显：XMLCoder 的 XMLDecoder 默认把所有 tag 当作 element，attribute 必须显式标注；没标注的 attribute 会被静默丢弃，不会报错也不会警告。
实操建议：
- Struct 字段加
@XMLAttribute前，确认 XML 中该字段确实是 attribute（在尖括号内、等号右侧），不是子元素 - 遇到
XMLDecodingError，先检查是否混用了@XMLElement和@XMLAttribute，或命名大小写不一致（XML 是大小写敏感的） - 性能影响：相比纯
XMLParser，XMLCoder多一层反射开销，但开发效率提升明显；100KB 以内 XML 基本无感
XML 文件里有 namespace 怎么办
带 namespace 的 XML（如 <rss xmlns="http://purl.org/rss/1.0/"></rss>）会让 XMLCoder 直接解码失败，报 XMLDecodingError.missingElement，因为默认忽略 namespace，匹配不到 root。
根本原因：XML namespace 不是装饰，而是作用域标识，XMLCoder 默认不开启 namespace 支持，也不做前缀剥离。
实操建议：
- 临时方案：用
String.replacingOccurrences(of: "xmlns=\"...\"", with: "")预处理 XML 字符串（仅限测试或单次解析） - 正式方案：用
XMLCoder的XMLDecoder配置keyEncodingStrategy = .byName并配合自定义userInfo传入 namespace URI，再在 Struct 字段上用@XMLElement(namespace: "...") - 更稳的做法：改用
SWXMLHash先解析成字典树，再映射到 Struct——它对 namespace 天然友好，但失去Codable一致性
复杂点在于：同一个 XML 可能混合多个 namespace（比如 dc:date、media:thumbnail），这时每个字段的 @XMLElement(namespace: ...) 必须精确匹配，错一个就为 nil。没人帮你校验 namespace URI 是否拼错，只能靠打印原始 XML 对照。
