TypeError的根本原因是对象不支持所执行的操作，本质是类型误用而非语法错误，如int[0]是对类型本身索引、"hello"+42因+运算符拒绝隐式转换、a,b=None因None不可迭代导致解包失败。
Python中出现TypeError，根本原因只有一个：你正在对一个对象执行它不支持的操作——不是它“错了”，而是你用错了它的身份。
为什么int[0]会报TypeError: 'type' object is not subscriptable
这不是语法错误，是类型误用。当你写int[0]，Python看到的不是“取整数的第一个字节”，而是“对int这个类型本身做下标访问”。而类型（如int、list、str）不是容器，不能被索引。
- 常见诱因包括：
list = [1, 2, 3]覆盖了内置list后，又写list[0]——此时list已是列表实例，但若之前被赋值为list = 42，那list[0]就真成了“对整数索引” - 自定义类没实例化就直接
MyClass[0]，和int[0]本质一样：操作的是类，不是实例 - 调试时忘了检查变量实际类型，仅凭名字猜测——比如看到变量叫
data就默认能data['key']，但它可能是个tuple
为什么"hello" + 42报can only concatenate str (not "int") to str
Python的+对字符串和数字有完全不同的语义：字符串拼接 vs 数值加法。解释器不会自动帮你转类型，因为“转成字符串”和“转成ASCII码相加”都合理，它拒绝做主观猜测。
- 这不是bug，是设计约束：避免隐式转换带来的歧义和性能开销
-
str(42)、f"hello {42}"、"hello".format(42)都是显式且安全的选择 - 注意
print("hello", 42)不报错——因为print接受任意类型参数，内部做了str()处理；但+运算符不会
为什么a, b = None报cannot unpack non-iterable NoneType object
解包（unpacking）要求右侧必须是可迭代且长度匹配的对象。None既不可迭代，也不含元素，所以连“有多少个值要拆”都不知道。
python-script-generator
下载
快速生成专业的 Python 脚本和应用代码。一键创建完整项目结构，支持CLI、API、爬虫、Bot、Django等多种项目类型，包含完整的项目结构、配置文件、依赖管理、测试、README和文档。
立即学习“Python免费学习笔记（深入）”；
- 高频场景：函数在某些分支没返回值（等价于返回
None），调用方却直接解包 - 数据库查询没命中、API返回空响应、配置缺失时，容易漏掉
if result is not None:检查 - 修复不单是加
try/except，更要回溯源头：那个函数本该返回什么？为什么返回了None？
排查TypeError最有效的三件事
别急着改代码，先确认事实：
- 在报错行前加
print(type(x), repr(x))——repr()比print(x)更能暴露None、空字符串、全空列表等易忽略状态 - 用
isinstance(x, expected_type)代替type(x) == expected_type，兼容继承关系 - 如果涉及外部数据（JSON、CSV、数据库），在首次接收后立刻打日志：
logging.debug("raw data type: %s, sample: %r", type(data), data[:3] if hasattr(data, '__getitem__') else data)
真正棘手的TypeError往往藏在类型“看似正确实则脆弱”的地方：比如一个函数文档说“返回字典”，但实际可能返回None；或API声称返回list，结果空响应时给的是dict。这时候，类型检查不是锦上添花，而是必经门槛。
