Python TypeError解析：常见报错含义及修复方法

TypeError是Python中最常见的异常类型之一，当你执行的操作、调用的函数/方法，或者使用的运算符，与操作对象的数据类型不兼容时，就会触发这个异常。简单来说，就是你“用错了类型”——要么是参数数量/类型不对，要么是对某个类型做了它不支持的操作。

下面针对你列出的常见报错，分场景解析含义和解决办法：

一、函数/类调用的参数问题 #

这类报错都是因为调用函数、方法或实例化类时，参数的数量、类型、传递方式不符合定义要求：

• TypeError: func() takes 0 positional arguments but 1 was given：函数定义时没要求接收位置参数，但调用时多传了1个。解决：要么修改函数定义，让它能接收这个参数；要么调用时去掉多余的参数。
• TypeError: func() takes from 1 to 2 positional arguments but 3 were given：函数只接受1-2个位置参数，你传了3个。解决：检查调用时的参数数量，删掉多余的；或者调整函数定义，让它支持更多参数。
• TypeError: func() got an unexpected keyword argument 'arg'：函数不接受名为arg的关键字参数。解决：检查参数名拼写是否正确，或者修改函数定义，添加这个参数的接收逻辑。
• TypeError: func() missing 1 required positional argument: 'arg'：函数必须接收arg这个位置参数，但你调用时没传。解决：调用时补上这个参数；或者给函数的arg参数设置默认值，让它变成可选参数。
• TypeError: func() missing 1 required keyword-only argument: 'arg'：函数要求arg必须以关键字形式传递（比如定义时用了*分隔），但你没传。解决：调用时用func(arg=xxx)的形式传参。
• TypeError: func() got multiple values for argument 'arg'：同一个参数arg既通过位置传了值，又通过关键字传了值；或者参数定义顺序有问题（比如位置参数放在了带默认值的参数后面）。解决：确保每个参数只传一次，调整函数参数的定义顺序。
• TypeError: MyClass() takes no arguments：这个类的__init__方法只定义了self参数，但你实例化时传了额外参数。解决：要么实例化时不传参数；要么修改类的__init__方法，让它能接收你要传的参数。

二、操作/类型转换的类型不兼容问题 #

这类报错是因为对某个数据类型执行了它不支持的操作：

• TypeError: unsupported operand type(s) for +: 'int' and 'str' / TypeError: can only concatenate str (not "int") to str：Python不允许直接把整数和字符串相加。解决：把整数转成字符串（str(num)），或者把字符串转成整数（int(s)）后再操作。
• TypeError: '>' not supported between instances of 'int' and 'str'：不能直接比较整数和字符串的大小。解决：先把两者转成同一类型，再做比较。
• TypeError: can't multiply sequence by non-int of type 'float'：字符串、列表这类序列只能乘以整数，你用了浮点数。解决：把浮点数转成整数（比如int(2.5)），或者换用其他方式实现你的需求。
• TypeError: string indices must be integers / TypeError: list indices must be integers or slices, not str：访问字符串或列表的元素时，索引必须是整数或切片，你用了字符串当索引。解决：检查索引值，确保是整数类型。
• TypeError: %d format: a number is required, not str / TypeError: not all arguments converted during string formatting：用%格式化字符串时，占位符和参数类型不匹配，或者参数数量不够。解决：确保占位符（比如%d对应数字，%s对应字符串）和参数类型一致，且参数数量对应。
• TypeError: int() argument must be a string, a bytes-like object or a number, not 'list'：int()函数只能把字符串、字节或数字转成整数，你传了列表。解决：检查传入int()的对象，确保是合法类型。
• TypeError: a bytes-like object is required, not 'str'：需要传入字节类型的地方，你传了字符串。解决：把字符串转成字节（比如s.encode('utf-8')）。
• TypeError: bad operand type for abs(): 'str'：abs()函数只能处理数字，你传了字符串。解决：确保传入abs()的是数字类型。
• TypeError: descriptor 'to_bytes' for 'int' objects doesn't apply to a 'str' object：to_bytes是整数的方法，你试图在字符串上调用它。解决：先把字符串转成整数，再调用该方法。
• TypeError: 'int' object is not iterable：试图用for循环遍历整数，但整数不是可迭代对象。解决：检查遍历的对象，确保是列表、字符串这类可迭代类型。
• TypeError: cannot unpack non-iterable int object：试图把整数解包（比如a, b = 10），但整数不能被拆分成多个元素。解决：确保解包的对象是可迭代的，且元素数量和变量数量匹配。
• TypeError: 'int' object is not callable：把整数当成函数调用了（比如num = 5; num()）。解决：检查变量名是否和函数名重名，确保你调用的是函数而不是整数变量。
• TypeError: 'int' object is not subscriptable：试图用下标访问整数（比如num[0]），但整数不支持下标操作。解决：确保你访问下标的对象是字符串、列表这类支持下标的类型。

三、库中的自定义TypeError #

使用第三方库时遇到的自定义TypeError，是库开发者针对特定场景抛出的，这类报错需要结合库的官方文档来理解——通常是你传入的参数类型、格式不符合库的要求，按照文档调整参数即可。

内容的提问来源于Stack Exchange，提问作者Karl Knechtel