None被当成列表或字典用的本质是对其执行下标操作（如data[0]、config['host']），而变量实际值为None；常见原因包括函数无返回值、分支遗漏return、API空响应未处理、json.loads()输入为空、工具函数查不到返回None、Django first()查无结果、re.search()匹配失败等。
为什么None会被当成列表或字典用？
这个错误本质是：你试图对None做下标操作，比如data[0]、config['host']，但data或config实际值是None。常见原因是函数没返回值（默认返回None），或者条件分支漏了return，又或者API调用失败后没处理空响应。
别急着加if data is not None:——先确认None从哪来才是关键。
-
json.loads()遇到空字符串或None输入会返回None，不是抛异常 - 自己写的工具函数，比如
find_user_by_id()查不到时返回None，但调用方直接写了user['name'] - Django的
Model.objects.filter(...).first()查不到时返回None，而非空QuerySet -
re.search()匹配失败返回None，但代码直接用了match.group(1)
怎么快速定位出问题的变量？
加一行print(type(x), x)比猜快得多。尤其注意链式调用：resp.json()['data'][0]['id']——只要中间任意一环是None，报错位置永远显示最后一段（比如['id']），但真正出问题的可能是resp.json()返回None。
- 把长链拆成单步赋值：
data = resp.json(); items = data['data']; item = items[0]，错误会立刻暴露在哪一步 - 用
pprint看结构：from pprint import pprint; pprint(resp.content)，确认HTTP响应体是否为空或格式异常 - 在可疑函数入口加
assert value is not None, f"Expected non-None, got {type(value)}"，提前拦截
安全取值的几种写法，别硬扛None
不是所有地方都适合加if判断。根据场景选合适方式：
立即学习“Python免费学习笔记（深入）”；
- 字典取值优先用
.get()：config.get('timeout', 30)，避免KeyError也防None - 嵌套结构用
dict.get()链式调用：data.get('result', {}).get('items', [])[0]，但注意[0]仍可能越界 - 需要深度安全访问时，用
pydantic或box类库，或手写safe_get(data, 'a.b.c', default='N/A') - 正则匹配必须检查
match：match = re.search(pattern, text); name = match.group(1) if match else ''
函数设计时怎么避免制造None陷阱？
你自己写的函数如果可能返回None，就等于埋雷。明确契约比事后防御更省力。
- 查不到数据时，考虑抛异常（如
raise ValueError("User not found")）而不是返回None，让调用方无法忽略 - 配置加载失败，直接
sys.exit(1)或raise ConfigError，别留个None让下游崩溃 - API封装函数统一约定：成功返回字典/对象，失败返回
{'error': 'xxx'}，绝不混用None和字典 - 类型提示强制约束：
def parse_config() -> dict:，配合mypy能在编码阶段发现潜在None传播
最麻烦的不是报错本身，而是None在多层函数间静默传递，最后在某个无关紧要的打印语句里突然炸开。盯住源头，比到处加防御更有效。
