常见的 Python 错误及其解决方案

此文整理了一些常见的 Python 错误及其解决方案。

1、SyntaxError: invalid syntax

说明：无效的语法是最常见的错误之一，通常是由于编写代码时违反了 Python 的语法规则。可能的原因：

1. 忘记在 if、while、for 等语句后写冒号，或者将冒号写成分号或其他符号。解决方案：更改为英文半角冒号。
2. 代码中可能存在未正确关闭的括号，或者在字符串中使用的引号未正确匹配。解决方案：检查括号，引号处。
3. 条件表达式中出现等号（=）。解决方案：将其更改为比较运算符（==）。
4. 定义没有参数的函数时未添加括号。解决方案：添加括号。
   …

查看错误提示信息，通常会指出出错的行数和位置。合适的代码编辑器也会在代码中标记出语法错误。

2、Syntax Error: non-default argument follows default argument

说明：定义的参数顺序不正确。可能的情况：

默认值参数未放在所有参数的末尾。解决方案：更改参数的顺序。

3、SyntaxError : invalid character in identifier

说明：标识符中存在无效字符，通常是由于在标识符（变量名、函数名、类名等）中使用了无效的字符引起的。在 Python 中，标识符必须遵循一定的命名规则，不能包含特殊字符或空格，只能包含字母、数字和下划线，并且必须以字母（或者下划线 _）开头。可能的原因：

1. 标识符中包含了不被 Python 认可的特殊字符，如 @、#、$、% 等。
2. 标识符中包含空格或制表符。
3. 标识符以数字开头。
4. 标识符与 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() 函数传递的参数无效。可能的原因：

1. 字符串中包含了非数字字符。解决方案：确保字符串中只包含数字字符。可以使用 str.isdigit() 方法来检查字符串是否只包含数字字符。
2. 尝试将包含小数点的字符串转换为整数。解决方案：如果字符串可能包含浮点数，使用 float() 函数将其转换为浮点数，然后再将其转换为整数。
3. 过大或过小的数字：尝试将超出整数表示范围的数字字符串转换为整数。解决方案：数字太大或太小以至于超出了 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’

说明：模块没有相关属性。可能的原因：

1. 拼写错误：尝试访问的属性或方法名的拼写不正确。解决方案：检查拼写，确保使用正确的属性或方法名。
2. 命名 .py 文件时使用 Python 保留字或与模块名称相同。解决方案：修改文件名
3. 模块重命名：如果导入了一个模块并使用了别名，那么需要使用别名来访问模块的属性或方法。解决方案：使用正确的别名来访问属性或方法。

12、AttributeError: ‘Obj’ object has no attribute ‘attr’

说明：对象没有相关属性。可能的原因：

1. 拼写错误：您尝试访问的属性或方法名的拼写不正确。解决方案：检查拼写，确保使用正确的属性或方法名。
2. 如果属性或方法是私有的（以双下划线 __ 开头），则不能直接访问。解决方案：如果要访问私有属性或方法，可以使用单下划线 _ 或通过类的方法进行访问。
3. 对象类型错误：有时，可能在一个对象上调用应该是类的方法，或者尝试在一个非对象上调用对象方法。解决方案：确保按照正确的方式使用对象方法和类方法。对象方法需要在对象上调用，而类方法需要在类上调用

13、FileExistsError: [Errmo 17] File exists

说明：该文件已存在。解决方案：首先检查文件是否存在，如果存在，请不要再次创建它。

14、FileNotFoundError: [Ermo 2] No such file or directory

说明：请求的文件或目录不存在。解决方案：检查文件或目录的路径是否正确

15、IndentationError: expected an indented block

说明：需要缩进块。可能的原因：

1. 在定义函数或类时没有缩进。 解决方案：添加缩进
2. 在 if、for 或 while 语句的结构下没有缩进。解决方案：添加缩进

16、IndentationError: unexpected indent

说明：缩进错误。可能的原因：除了缩进之外，代码前面还会出现额外的空格。解决方案：删除多余的空格。

17、IndentationError: unindent does not match any outer indentation level

说明：缩进问题。可能的原因：

1. 同一级别的代码块使用不同的缩进规则（代码未对齐）。解决方案：调整缩进。
2. 有非法字符或其他格式的不可见内容。解决方案：删除非法字符。

18、IndexError: list index out of range

说明：列表索引超出范围，可能的原因：

1. 获取元素时指定的索引值超过列表的长度。解决方案：修改索引值
2. 列表为空，获取元素时出错。解决方案：在获取之前检查它是否不为空。

19、DirectoryError: [Ermo 21] Is a directory

说明：尝试对文件进行操作但提供了目录。可能的原因：将目录作为文件进行操作，例如，如果 “test” 是一个目录，则使用 os.remove(test) 将导致错误。解决方案：添加相应的文件名

20、KeyError: ‘age’

说明：键错误。可能的原因：

1. 基于键获取字典的值时，指定的键不存在。解决方案：修改为已有的键。
2. 删除了不存在的键。解决方案：在删除之前检查它是否存在。

21、ModuleNotFoundError: No module named‘pymysql’

说明：模块不存在。可能的原因：

1. 模块名称拼写错误。解决方案：更正拼写
2. 模块未导入。解决方案：使用 import 语句导入模块。
3. 环境问题：有时，虽然已经安装了模块，但在运行代码的环境中找不到它。这可能是因为正在使用的环境中未安装。解决方案：确保在虚拟环境中安装了所使用的模块。
4. 某些模块可能不支持使用的 Python 版本。解决方案：确保所用 Python 版本与导入模块兼容。查看模块文档以了解它所支持的 Python 版本。

22、NameError:name test’ is not defined

说明：在代码中尝试使用一个未定义或不存在的变量或名称（‘test’），或者在当前的作用域内无法找到该名称。可能的原因：

1. 变量或名称未定义。解决方案：在使用之前，定义变量或名称。
2. 变量可能在不同的作用域内定义（例如函数内部或条件块内部），而试图在该作用域之外访问它。解决方案：如果需要在函数外部或不同的作用域内使用变量，在全局作用域内定义它。

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.

说明：连接超时。可能的原因：

1. 数据库连接超时。解决方案：检查数据库连接配置信息是否正确。
2. 请求网址超时。解决方案：检查 URL 是否正确且可以访问。
3. 连接到 FTP 服务器超时。解决方案：检查用于连接到 FTP 的参数是否正确。