Python轻量级XML数据处理库之xmltodict使用详解

---

概要

xmltodict是一个轻量级且功能强大的Python第三方库，其设计理念是让XML数据处理变得如同操作JSON一样直观简单。该库基于高性能的Expat解析器构建，能够快速将XML文档转换为Python字典结构，也支持将字典数据逆向转换为XML格式。xmltodict最大的优势在于其简洁的API设计和出色的性能表现，特别适合处理复杂的XML数据转换任务。

---

安装

1、安装方法

xmltodict可以通过多种方式进行安装，最常用的方法是使用pip包管理器：

pip install xmltodict

对于Python 3环境，推荐使用：

pip3 install xmltodict

在系统级别安装可使用各操作系统的包管理器：

# Ubuntu/Debian系统
sudo apt-get install python3-xmltodict

# Fedora系统
sudo dnf install python-xmltodict

# openSUSE系统
sudo zypper in python3-xmltodict

# 使用conda安装
conda install anaconda::xmltodict

2、验证安装

安装完成后，可以通过以下命令验证xmltodict是否正确安装：

import xmltodict
print("xmltodict安装成功!")

# 快速测试基本功能
test_xml = "<root><item>test</item></root>"
result = xmltodict.parse(test_xml)
print(result)  # 应输出: {'root': {'item': 'test'}}

特性

• JSON风格的XML处理：将XML数据转换为类似JSON的Python字典结构，操作直观简便

• 双向转换支持：提供parse()和unparse()方法，支持XML到字典以及字典到XML的双向转换

• 高性能解析器：基于Expat解析器构建，处理速度快，内存占用低

• 流式处理模式：支持大型XML文件的流式解析，适合处理GB级别的XML数据

• 属性和文本处理：智能处理XML属性和文本内容，使用@前缀标识属性，#text标识文本内容

• 命名空间支持：提供完整的XML命名空间处理能力，支持命名空间展开和折叠

基本功能

1、XML到字典的转换

下面的代码示例展示了xmltodict最核心的功能：将XML文档解析为Python字典。这个功能特别适用于需要处理API响应数据、配置文件或任何结构化XML内容的场景。

import xmltodict
import json

# 复杂XML示例
xml_data = """
<bookstore>
    <book id="1" category="fiction">
        <title lang="en">Great Gatsby</title>
        <author>F. Scott Fitzgerald</author>
        <price currency="USD">10.99</price>
    </book>
    <book id="2" category="science">
        <title lang="en">Brief History of Time</title>
        <author>Stephen Hawking</author>
        <price currency="USD">15.99</price>
    </book>
</bookstore>
"""

# 解析XML为字典
parsed_data = xmltodict.parse(xml_data)

# 美化输出查看结构
print(json.dumps(parsed_data, indent=2, ensure_ascii=False))

# 访问特定数据
books = parsed_data['bookstore']['book']
for book in books:
    print(f"书名: {book['title']['#text']}")
    print(f"作者: {book['author']}")
    print(f"价格: {book['price']['#text']} {book['price']['@currency']}")

2、字典到XML的转换

以下代码演示了如何将Python字典数据转换回XML格式。xmltodict的unparse方法支持美化输出，能够生成格式整齐、易于阅读的XML文档。

import xmltodict

# 构建字典数据
user_data = {
    'user': {
        '@id': '12345',
        'profile': {
            'name': '张三',
            'email': 'zhangsan@example.com',
            'preferences': {
                'language': 'zh-CN',
                'theme': 'dark',
                'notifications': {
                    '@enabled': 'true',
                    '#text': 'email'
                }
            }
        },
        'settings': {
            'privacy': 'public',
            'location': {
                '@visible': 'false',
                '#text': 'Beijing'
            }
        }
    }
}

# 转换为XML格式
xml_output = xmltodict.unparse(user_data, pretty=True)
print("生成的XML:")
print(xml_output)

# 保存到文件
with open('user_config.xml', 'w', encoding='utf-8') as f:
    f.write(xml_output)

高级功能

1、命名空间处理

xmltodict提供了强大的XML命名空间处理能力，允许开发者灵活控制命名空间的展开和折叠：

import xmltodict

# 包含命名空间的XML
namespaced_xml = """
<root xmlns="http://defaultns.com/"