0

0

Python xmltodict强制列表模式 解决单节点转JSON不是数组的问题

星降

星降

发布时间:2026-02-22 14:24:31

|

555人浏览过

|

来源于php中文网

原创

xmltodict.parse()默认单元素不转列表导致json字段类型不一致,需用force_list=['item']强制指定标签始终为列表,注意命名空间需预处理或完整匹配。

python xmltodict强制列表模式 解决单节点转json不是数组的问题

xmltodict.parse() 默认不把单元素转成列表,JSON里字段类型不一致

遇到 XML 里某个标签可能只出现一次、也可能出现多次时,xmltodict.parse() 默认会把单个 <item></item> 解析成 dict,多个就变成 list —— 导致下游 JSON 字段类型飘忽,Python 里用 for item in data['items'] 直接报 TypeError: 'dict' object is not iterable

force_list 参数指定哪些标签必须始终是列表

这不是全局开关,而是按需声明:告诉 xmltodict.parse() “只要看到这些标签名,不管里面几个,一律包成 list”。最常用写法是传一个字符串列表:

import xmltodict
xml = '<root><item>a</item></root>'
data = xmltodict.parse(xml, force_list=['item'])

结果 data['root']['item'] 就是 [{'#text': 'a'}],不是 {'#text': 'a'}。注意:force_list 值是标签名本身,不是 XPath 路径,也不区分大小写(内部用 .lower() 比对)。

  • 只写 force_list=['item'],不会影响 <user></user> 或嵌套的 <item></item> 子节点(除非也列进去)
  • 如果想让所有同名标签都强制列表,包括深层嵌套的,就老老实实把名字全列上,比如 ['item', 'entry', 'member']
  • 空 XML 标签如 <item></item> 也会被转成 [{}],不是 [None] 或空字符串

别漏掉命名空间导致 force_list 失效

带命名空间的 XML(比如 <item xmlns:ns="http://example.com"></item>),标签名实际是 {http://example.com}item,而 force_list=['item'] 匹配不上。

Motiff
Motiff

Motiff是由猿辅导旗下的一款界面设计工具,定位为“AI时代设计工具”

下载

立即学习Python免费学习笔记(深入)”;

  • 要么提前用正则或 lxml 剥掉命名空间再喂给 xmltodict
  • 要么在 force_list 里写完整带命名空间的键,但得先知道 NS URI,且格式要严格匹配(含花括号)
  • 更稳妥的做法:统一预处理 XML,删掉 xmlns 属性和前缀,避免解析时引入额外复杂度

xml.etree.ElementTree 对比:轻量需求别硬上 xmltodict

如果只是想确保某几个字段是 list,又不想引入第三方依赖,直接用标准库也能做:

import xml.etree.ElementTree as ET
def get_items(root):
    items = root.findall('item')
    return [{k: v for k, v in el.items()} | {'#text': el.text.strip() if el.text else ''} for el in items]

xmltodict 的优势在于整棵树一键转 dict,但代价是灵活性低、错误提示弱;一旦 XML 结构稍复杂(比如混合文本+子节点、属性冲突),force_list 就容易漏判或误判。

真正难处理的从来不是“单节点变数组”,而是“同一标签在不同层级语义不同”——这时候硬塞 force_list 反而让数据更难用。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

通义千问
通义千问

阿里巴巴推出的全能AI助手

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

443

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

544

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

322

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

81

2025.09.10

pdf怎么转换成xml格式
pdf怎么转换成xml格式

将 pdf 转换为 xml 的方法:1. 使用在线转换器;2. 使用桌面软件(如 adobe acrobat、itext);3. 使用命令行工具(如 pdftoxml)。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

1931

2024.04.01

xml怎么变成word
xml怎么变成word

步骤:1. 导入 xml 文件;2. 选择 xml 结构;3. 映射 xml 元素到 word 元素;4. 生成 word 文档。提示:确保 xml 文件结构良好,并预览 word 文档以验证转换是否成功。想了解更多xml的相关内容,可以阅读本专题下面的文章。

2107

2024.08.01

xml是什么格式的文件
xml是什么格式的文件

xml是一种纯文本格式的文件。xml指的是可扩展标记语言,标准通用标记语言的子集,是一种用于标记电子文件使其具有结构性的标记语言。想了解更多相关的内容,可阅读本专题下面的相关文章。

1134

2024.11.28

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

616

2023.08.03

pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法
pixiv网页版官网登录与阅读指南_pixiv官网直达入口与在线访问方法

本专题系统整理pixiv网页版官网入口及登录访问方式,涵盖官网登录页面直达路径、在线阅读入口及快速进入方法说明,帮助用户高效找到pixiv官方网站,实现便捷、安全的网页端浏览与账号登录体验。

1030

2026.02.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
最新Python教程 从入门到精通
最新Python教程 从入门到精通

共4课时 | 22.4万人学习

Django 教程
Django 教程

共28课时 | 4.4万人学习

SciPy 教程
SciPy 教程

共10课时 | 1.6万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号