xmltodict.parse()转字典再yaml.dump()是最稳方案，需注意encoding='utf-8'、allow_unicode=true、sort_keys=false等参数，并警惕字符串误传、命名空间、cdata等陷阱。
XML转YAML时，xmltodict 是最稳的起点
直接用 xmltodict.parse() 把 XML 字符串变成 Python 字典，再喂给 yaml.dump()，能避开绝大多数结构解析陷阱。它默认把重复标签转成列表、自动处理属性（加 @ 前缀）、不丢空元素——比手写 xml.etree.ElementTree 快且少出错。
常见错误现象：yaml.dump() 输出带单引号、缩进混乱、中文变 Unicode；或遇到 TypeError: object of type 'OrderedDict' is not JSON serializable（其实是没传 default_flow_style=False 或没处理不可序列化对象）。
- 必须加
encoding='utf-8'读 XML 文件，否则中文直接乱码 -
yaml.dump()要传allow_unicode=True，否则中文全变\u4f60 - 如果 XML 有命名空间（
xmlns），xmltodict默认会保留，但 YAML 里看着像冗余字段，可提前用process_namespaces=True简化
遇到 AttributeError: 'str' object has no attribute 'items' 怎么办
这是典型的数据结构没对齐：你传给 yaml.dump() 的不是字典，而是字符串（比如误把 xmltodict.parse() 的返回值又转了一次 str()），或者 XML 根节点下只有一个文本子节点，xmltodict 返回的是字符串而非字典。
使用场景：配置文件里只有 <host>api.example.com</host> 这种扁平结构时特别容易踩坑。
- 先打印
type(result)和result内容，确认是不是字符串 - 如果是单层文本，手动包一层：
{'config': result} - 别依赖
xmltodict的“自动推断”，显式指定根键名更可控，比如xmltodict.parse(xml_str, xml_attribs=False, process_namespaces=False)
在线转换器为啥经常崩或格式错乱
因为多数在线工具用的是浏览器端 JS 库（如 xml2js），它们对 XML 声明、注释、CDATA、DOCTYPE 处理极弱——遇到 <?xml version="1.0"?> 或 就直接报错或静默丢数据。
性能影响：JS 解析大 XML（>500KB）会卡死标签页；兼容性上，IE 完全不支持主流库。
- 本地跑
python -m pip install xmltodict pyyaml三行代码搞定，比粘贴到网页更可靠 - 如果非要用在线工具，先用编辑器删掉
<?xml ...?>和所有<!-- ... -->注释 - 含 CDATA 的 XML，务必先用正则或脚本提取内容，再手动塞进 YAML 对应字段，别指望自动识别
yaml.dump() 输出的 key 顺序和 XML 不一致
YAML 规范本身不要求 key 顺序，但人眼读配置时很依赖顺序。Python 3.7+ 的 dict 保序，但 xmltodict.parse() 返回的是 collections.OrderedDict，而部分旧版 pyyaml（
参数差异：新版本 pyyaml 需显式启用 sort_keys=False，否则默认按字母排。
- 确保装的是
pyyaml>=5.1（pip install --upgrade pyyaml） -
yaml.dump(data, sort_keys=False, default_flow_style=False, allow_unicode=True)这三个参数缺一不可 - 如果 XML 里有同名兄弟节点（如多个
<item></item>），xmltodict会转成 list，顺序天然保留；但若被误转成 dict 的不同 key，顺序就丢了——检查原始 XML 是否真有重复标签
复杂点在于 XML 的“隐式结构”：属性 vs 子节点、空标签含义、命名空间前缀是否要保留。这些不会报错，但会导致 YAML 语义偏移。动手前先用 print(json.dumps(result, indent=2, ensure_ascii=False)) 看一眼字典长什么样，比盲目调参快得多。
