TypeError: 'NoneType' object is not subscriptable 表示对None值进行了索引操作，根本原因是变量本应为列表、字典等可索引类型却为None，常见于无返回值函数、字典键缺失、正则匹配失败或异步异常未处理等情况。
为什么会出现 TypeError: 'NoneType' object is not subscriptable
这个错误意味着你试图对一个 None 值做下标操作（比如 obj[0]、obj['key'] 或 obj[i]），而 None 不支持索引。根本原因不是语法错，而是某个变量本该是列表、字典或字符串，结果却是 None —— 通常因为函数没返回值、提前 return、异常跳过初始化，或者调用失败后未处理返回值。
常见触发场景和对应修复方式
这类错误高频出现在以下几种情况：
-
调用了没有
return的函数：Python 函数默认返回None。例如写了个只打印不返回的parse_data()，却直接拿它结果做parse_data()[0] -
字典键不存在且没设默认值：如
config.get('db_url')返回None，后续又写config.get('db_url').split('://') -
正则匹配失败：
re.search(...)没匹配到时返回None，但代码仍假设它有.group(1) -
异步/IO 操作未 await 或异常中断：比如
await fetch_json()抛异常后变量保持未赋值状态，后续却当作 dict 使用
修复核心就一条：**在下标前确认对象非 None，且类型符合预期**。不要依赖“它应该不是 None”。
安全访问的实操建议
别靠 try/except 捕获这个错误来兜底——那说明逻辑已经失控。优先从源头预防或显式防御：
立即学习“Python免费学习笔记（深入）”；
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
- 对函数调用，检查是否漏了
return；如果函数可能返回None，加判断：if result is not None: ... - 字典取值优先用
.get(key, default)，且default应是合适类型（如空列表、空字典），而非None - 正则匹配后必须判空：
match = re.search(...); if match: value = match.group(1) - 链式访问（如
data['items'][0]['name']）极易崩，改用data.get('items', [{}])[0].get('name')或引入dict.get()多层封装 - 调试时快速定位：在报错行前加
print(type(obj), repr(obj))，看它真是None还是别的空值
一个典型修复对比示例
错误写法：
def get_user_config(user_id):
# 忘记 return，实际返回 None
db.query("SELECT * FROM users WHERE id = %s", user_id)
<p>config = get_user_config(123)
print(config['email']) # TypeError: 'NoneType' object is not subscriptable
修复后：
def get_user_config(user_id):
return db.query("SELECT * FROM users WHERE id = %s", user_id) # 补上 return
<p>config = get_user_config(123)
if config is None:
raise ValueError(f"No config found for user {user_id}")
print(config['email'])
更健壮的写法还会检查 config 是否为 dict，以及 'email' 键是否存在 —— 尤其当数据来源不可控时。
最易被忽略的是：这个错误往往发生在嵌套调用的深层，比如 A 调 B，B 调 C，C 返回了 None，A 却在最后一层才尝试下标。查的时候得顺着调用栈往回翻，而不是只盯报错那一行。
