此文整理了一些常见的 Python 错误及其解决方案。
1、SyntaxError: invalid syntax
说明:无效的语法是最常见的错误之一,通常是由于编写代码时违反了 Python 的语法规则。可能的原因:
- 忘记在
if
、while
、for
等语句后写冒号,或者将冒号写成分号或其他符号。解决方案:更改为英文半角冒号。 - 代码中可能存在未正确关闭的括号,或者在字符串中使用的引号未正确匹配。解决方案:检查括号,引号处。
- 条件表达式中出现等号(=)。解决方案:将其更改为比较运算符(==)。
- 定义没有参数的函数时未添加括号。解决方案:添加括号。
…
查看错误提示信息,通常会指出出错的行数和位置。合适的代码编辑器也会在代码中标记出语法错误。
2、Syntax Error: non-default argument follows default argument
说明:定义的参数顺序不正确。可能的情况:
默认值参数未放在所有参数的末尾。解决方案:更改参数的顺序。
3、SyntaxError : invalid character in identifier
说明:标识符中存在无效字符,通常是由于在标识符(变量名、函数名、类名等)中使用了无效的字符引起的。在 Python 中,标识符必须遵循一定的命名规则,不能包含特殊字符或空格,只能包含字母、数字和下划线,并且必须以字母(或者下划线 _
)开头。可能的原因:
- 标识符中包含了不被 Python 认可的特殊字符,如
@
、#
、$
、%
等。 - 标识符中包含空格或制表符。
- 标识符以数字开头。
- 标识符与 Python 的保留字或关键字冲突。
4、TypeError: can only concatenate str (not “XXX”) to str
说明:只能将字符串与其他字符串连接起来。可能的原因:
尝试将字符串与非字符串数据类型(如整数、浮点数、布尔值或序列对象)连接起来。解决方案:在连接之前使用 str()
函数转换数据类型。
5、TypeError: f() takes exactly 2 arguments (1 given)
说明:向函数提供的参数不足。可能的原因:
定义具有两个参数的函数,但在调用时仅提供一个参数。解决方案:提供缺少的参数以完成函数调用。
6、TypeError: ‘tuple’ object does not support item assignment
说明:无法修改元组元素。可能的原因:
尝试通过索引修改元组元素。解决方案:将元组转换为列表或移除修改操作。
7、ValueError: could not convert string to float:‘12.2s’
说明:无法将字符串转换为浮点数。可能的原因:
float()
函数接受了非浮点字符串数据类型。解决方案:修改为浮点字符串。
8、ValueError: invalid literal for int() with base 10
说明:向 int()
函数传递的参数无效。可能的原因:
- 字符串中包含了非数字字符。解决方案:确保字符串中只包含数字字符。可以使用
str.isdigit()
方法来检查字符串是否只包含数字字符。 - 尝试将包含小数点的字符串转换为整数。解决方案:如果字符串可能包含浮点数,使用
float()
函数将其转换为浮点数,然后再将其转换为整数。 - 过大或过小的数字:尝试将超出整数表示范围的数字字符串转换为整数。解决方案:数字太大或太小以至于超出了 Python 的整数表示范围,使用
float()
或其他数据类型来处理超大数值。
9、ValueError: substring not found
说明:在尝试查找一个子字符串时,该子字符串未在目标字符串中找到。这个错误可能会在使用字符串的 index()
、find()
、rfind()
等方法时触发。解决方案:搜索前检查。
10、ZeroDivisionError: division by zero
说明:0 不能用作除数。可能的原因:执行除法、整除或取余运算时,使用 0 作为除数。解决方案:在进行除法操作之前,检查除数是否为零;使用条件语句避免除以零的情况发生。
11、AttribteError: ‘module’ object has no attribute xxx’
说明:模块没有相关属性。可能的原因:
- 拼写错误:尝试访问的属性或方法名的拼写不正确。解决方案:检查拼写,确保使用正确的属性或方法名。
- 命名
.py
文件时使用 Python 保留字或与模块名称相同。解决方案:修改文件名 - 模块重命名:如果导入了一个模块并使用了别名,那么需要使用别名来访问模块的属性或方法。解决方案:使用正确的别名来访问属性或方法。
12、AttributeError: ‘Obj’ object has no attribute ‘attr’
说明:对象没有相关属性。可能的原因:
- 拼写错误:您尝试访问的属性或方法名的拼写不正确。解决方案:检查拼写,确保使用正确的属性或方法名。
- 如果属性或方法是私有的(以双下划线
__
开头),则不能直接访问。解决方案:如果要访问私有属性或方法,可以使用单下划线_
或通过类的方法进行访问。 - 对象类型错误:有时,可能在一个对象上调用应该是类的方法,或者尝试在一个非对象上调用对象方法。解决方案:确保按照正确的方式使用对象方法和类方法。对象方法需要在对象上调用,而类方法需要在类上调用
13、FileExistsError: [Errmo 17] File exists
说明:该文件已存在。解决方案:首先检查文件是否存在,如果存在,请不要再次创建它。
14、FileNotFoundError: [Ermo 2] No such file or directory
说明:请求的文件或目录不存在。解决方案:检查文件或目录的路径是否正确
15、IndentationError: expected an indented block
说明:需要缩进块。可能的原因:
- 在定义函数或类时没有缩进。 解决方案:添加缩进
- 在
if
、for
或while
语句的结构下没有缩进。解决方案:添加缩进
16、IndentationError: unexpected indent
说明:缩进错误。可能的原因:除了缩进之外,代码前面还会出现额外的空格。解决方案:删除多余的空格。
17、IndentationError: unindent does not match any outer indentation level
说明:缩进问题。可能的原因:
- 同一级别的代码块使用不同的缩进规则(代码未对齐)。解决方案:调整缩进。
- 有非法字符或其他格式的不可见内容。解决方案:删除非法字符。
18、IndexError: list index out of range
说明:列表索引超出范围,可能的原因:
- 获取元素时指定的索引值超过列表的长度。解决方案:修改索引值
- 列表为空,获取元素时出错。解决方案:在获取之前检查它是否不为空。
19、DirectoryError: [Ermo 21] Is a directory
说明:尝试对文件进行操作但提供了目录。可能的原因:将目录作为文件进行操作,例如,如果 “test” 是一个目录,则使用 os.remove(test)
将导致错误。解决方案:添加相应的文件名
20、KeyError: ‘age’
说明:键错误。可能的原因:
- 基于键获取字典的值时,指定的键不存在。解决方案:修改为已有的键。
- 删除了不存在的键。解决方案:在删除之前检查它是否存在。
21、ModuleNotFoundError: No module named‘pymysql’
说明:模块不存在。可能的原因:
- 模块名称拼写错误。解决方案:更正拼写
- 模块未导入。解决方案:使用
import
语句导入模块。 - 环境问题:有时,虽然已经安装了模块,但在运行代码的环境中找不到它。这可能是因为正在使用的环境中未安装。解决方案:确保在虚拟环境中安装了所使用的模块。
- 某些模块可能不支持使用的 Python 版本。解决方案:确保所用 Python 版本与导入模块兼容。查看模块文档以了解它所支持的 Python 版本。
22、NameError:name test’ is not defined
说明:在代码中尝试使用一个未定义或不存在的变量或名称(‘test’),或者在当前的作用域内无法找到该名称。可能的原因:
- 变量或名称未定义。解决方案:在使用之前,定义变量或名称。
- 变量可能在不同的作用域内定义(例如函数内部或条件块内部),而试图在该作用域之外访问它。解决方案:如果需要在函数外部或不同的作用域内使用变量,在全局作用域内定义它。
23、RecursionEror:maximum rcusion depth exceded in comprison
说明:超出最大递归深度。解决方案:禁止无限递归,设置递归深度。
24、Timeout error [WinError 10060] No response or response from host after a period of time. Connection attempt failed.
说明:连接超时。可能的原因:
- 数据库连接超时。解决方案:检查数据库连接配置信息是否正确。
- 请求网址超时。解决方案:检查 URL 是否正确且可以访问。
- 连接到 FTP 服务器超时。解决方案:检查用于连接到 FTP 的参数是否正确。