XML转YAML需先用ElementTree或lxml解析为Python结构，再用PyYAML转换；须处理命名空间、空标签、混合内容、重复子节点、属性分离、中文编码、时间格式及引号控制等问题。
XML转YAML时xml.etree.ElementTree解析失败：空标签、命名空间、属性混排
PyYAML本身不处理XML，必须先用xml.etree.ElementTree或lxml解析成Python结构，再转YAML。常见错误是直接读XML字符串就喂给yaml.dump()，结果输出全是None或报TypeError: object of type 'Element' is not serializable。
真实场景里，XML常含命名空间（如xmlns="http://example.com/ns"）、自闭合标签（<item/>）、混合文本+子节点（<p>hello<b>world</b></p>），这些都会让默认ElementTree解析后结构难映射到YAML的键值逻辑。
- 用
xml.etree.ElementTree.fromstring()前，先用re.sub()剥离命名空间（除非你主动用{http://...}tag方式访问） - 空标签（
<flag/>）默认解析为element.text == None，建议统一转成""或False，避免YAML里出现null歧义 - 含混合内容的节点（文本+子元素）不要硬塞进dict；要么提取纯文本（
"".join(element.itertext())），要么跳过——YAML不适合表达这种HTML式嵌套
PyYAML dump时中文乱码、单引号绕过、时间格式崩坏
直接yaml.dump(data)默认用ASCII编码、自动加单引号包裹字符串、把datetime对象转成不可读的!!python/object/apply:datetime.datetime——这在配置文件里完全不可用。
核心是控制default_flow_style、allow_unicode和default_style三个参数，且必须显式传入，不能依赖全局设置。
立即学习“Python免费学习笔记（深入）”；
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
- 中文输出必须加
allow_unicode=True，否则全变\u4f60\u597d - 避免无意义单引号：设
default_style=None（不是"None"字符串） - 时间类型要提前转成ISO字符串：
str(dt)或dt.isoformat()，别指望PyYAML自动格式化 - 如果原始XML有数字字符串如
"00123"，ElementTree会当str读入，但YAML可能解析成整数123——需要手动补引号或加yaml.dump(..., default_flow_style=False)保格式
嵌套层级深、重复标签名导致字典key冲突
XML里常见<list><item>a</item><item>b</item></list>，ElementTree解析后list下多个同名item子节点，若直接转dict会只保留最后一个——因为Python dict key不能重复。
这不是PyYAML的问题，是XML→Python结构映射阶段就断掉了。必须在生成dict前识别重复标签，并强制转为list。
- 检查
elem.findall("item")长度是否>1，若是，把所有item节点内容收集进list，而非逐个赋值给同一key - 别用
elem.attrib直接合并进内容字典——属性和文本语义不同，强行合在一起会让YAML结构模糊（比如id="123"和text="name"都变成同级key） - 简单方案：对每个节点，生成
{"@attrs": {...}, "#text": "...", "child": {...}}三层结构；复杂项目建议用xmltodict库替代手写解析
脚本跑通但生成YAML和预期结构不符：缩进、换行、注释全丢
XML带注释（<!-- desc -->）或人为换行缩进，在ElementTree里直接被忽略；PyYAML dump也默认不保留空行、不支持写注释。所谓“结构不符”，其实是把XML的排版习惯错当成语义要求。
配置文件YAML的关键是可读性+机器可解析，不是像素级还原XML格式。强行模拟只会增加维护成本。
- PyYAML不支持输出注释——别试
yaml.dump(..., comment="xxx")，没这个参数 - 缩进用
indent=2控制，但无法对某一层单独设；设indent=4后所有嵌套都变4空格，别指望“根层2格、子层4格” - 换行靠
default_flow_style=False+width=1000（禁掉折行），但长列表仍会换行——这是YAML规范行为，不是bug
真正该花时间的地方，是定义清楚哪些字段必须保留顺序（用collections.OrderedDict）、哪些值必须加引号（字符串含冒号/井号时）、哪些空节点要显式写成null而不是省略——这些细节比缩进更影响下游使用。
