错误原因是将列表误当字典调用 items() 方法,因 items() 仅属于 dict;需先用 type() 确认数据结构,再按 list(遍历元素后调用 items)或 dict(直接调用 items)处理。

这是把列表当字典用了,直接改数据结构或访问方式就能解决。
为什么会出现 AttributeError: 'list' object has no attribute 'items'
因为 items() 是字典(dict)的方法,而你调用它的对象实际是列表(list)。常见于:从 JSON 解析、API 返回、配置读取后没检查类型,就默认它是字典。
- API 返回
[{"id": 1, "name": "a"}, {"id": 2, "name": "b"}]—— 这是列表,不是字典 -
json.loads('["a","b"]')得到的是list,不是dict - 误写成
data.items(),但data其实是[...]
怎么快速确认变量类型并修复访问逻辑
先打印 type(data) 和 repr(data) 看清真实结构,再决定怎么遍历。
- 如果是列表(含多个字典):用
for item in data:,然后对每个item调用.items() - 如果是单个字典:确保没多套一层列表,比如
data = response.json()[0]或data = data[0] if isinstance(data, list) else data - 想统一处理,可加类型判断:
if isinstance(data, dict): data.items() elif isinstance(data, list): ...
示例:
data = [{"name": "Alice", "age": 30}, {"name": "Bob", "age": 25}]
# ❌ 错误
# for k, v in data.items(): ...
<h1>✅ 正确:遍历列表里的每个字典</h1><p>for user in data:
for k, v in user.items(): # 这里 user 是 dict
print(k, v)</p>
容易忽略的边界情况和调试技巧
空列表、嵌套过深、混合类型(如 [{}, []])会让 isinstance 检查失效,光靠 try/except 不够可靠。
- 别只测成功路径,加一句
print(f"type: {type(data)}, len: {len(data) if hasattr(data, '__len__') else 'N/A'}") - 用
pprint.pprint(data)替代print(data),看清嵌套层级 - 如果来自第三方库(如
requests),检查文档返回值定义,有些接口返回dict,有些返回list,取决于查询参数
最常踩的坑不是不会写 items(),而是没意识到自己拿到的压根不是 dict —— 多打一行 type() 就能省掉半小时调试。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











