常见的 Python 错误及其解决方案
此文整理了一些常见的 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 的参数是否正确。