Python 错误代码

因各种算术错误而引发的内置异常的基类：OverflowError、ZeroDivisionError、FloatingPointError。

当断言语句失败时引发。

当属性引用（请参阅属性引用）或分配失败时引发。 （当对象根本不支持属性引用或属性分配时，会引发 TypeError。） 可选的 name 和 obj 仅关键字参数设置相应的属性：

这两种异常类型都将异常包装在序列 excs 中。 msg 参数必须是字符串。这两个类的区别在于，BaseExceptionGroup 扩展了 BaseException，它可以包装任何异常，而 ExceptionGroup 扩展了 Exception，它只能包装 Exception 的子类。这种设计是为了让 except Exception 捕获 ExceptionGroup 而不是 BaseExceptionGroup。 如果所有包含的异常都是 Exception 实例，则 BaseExceptionGroup 构造函数将返回 ExceptionGroup 而不是 BaseExceptionGroup，因此它可用于自动进行选择。另一方面，如果任何包含的异常不是 Exception 子类，则 ExceptionGroup 构造函数将引发 TypeError。 异常组对于其所包含的异常的类型是通用的。 请注意，BaseExceptionGroup 定义了 __new__()，因此需要不同构造函数签名的子类需要重写它而不是 __init__()。例如，以下定义了一个异常组子类，它接受 exit_code 并从中构造该组的消息。 与 ExceptionGroup 一样，BaseExceptionGroup 的任何子类（也是 Exception 的子类）只能包装 Exception 的实例。

当操作阻塞设置为非阻塞操作的对象（例如套接字）时引发。对应于 errno EAGAIN、EALREADY、EWOULDBLOCK 和 EINPROGRESS。 除了 OSError 之外，BlockingIOError 还可以有一个属性：

ConnectionError 的子类，当尝试在另一端已关闭的情况下在管道上写入时引发，或者尝试在已关闭写入的套接字上写入时引发。对应于 errno EPIPE 和 ESHUTDOWN。

当无法执行缓冲区相关操作时引发。

与字节和字节数组相关的警告的基类。

当对子进程的操作失败时引发。对应于 errno ECHILD。

ConnectionError 的子类，当对等方中止连接尝试时引发。对应于 errno ECONNABORTED。

连接相关问题的基类。 子类有 BrokenPipeError、ConnectionAbortedError、ConnectionRefusedError 和 ConnectionResetError。

ConnectionError 的子类，当连接尝试被对等方拒绝时引发。对应于 errno ECONNREFUSED。

ConnectionError 的子类，当对等方重置连接时引发。对应于 errno ECONNRESET。

有关已弃用功能的警告的基类（当这些警告适用于其他 Python 开发人员时）。 被默认警告过滤器忽略，__main__ 模块中除外 (PEP 565)。启用 Python 开发模式会显示此警告。 PEP 387 中描述了弃用政策。

当 input() 函数遇到文件结束条件 (EOF) 且未读取任何数据时引发。 （注意：io.TextIOBase.read() 和 io.IOBase.readline() 方法在遇到 EOF 时返回空字符串。）

与编码相关的警告的基类。 有关详细信息，请参阅选择加入编码警告。

这两种异常类型都将异常包装在序列 excs 中。 msg 参数必须是字符串。这两个类的区别在于，BaseExceptionGroup 扩展了 BaseException，它可以包装任何异常，而 ExceptionGroup 扩展了 Exception，它只能包装 Exception 的子类。这种设计是为了让 except Exception 捕获 ExceptionGroup 而不是 BaseExceptionGroup。 如果所有包含的异常都是 Exception 实例，则 BaseExceptionGroup 构造函数将返回 ExceptionGroup 而不是 BaseExceptionGroup，因此它可用于自动进行选择。另一方面，如果任何包含的异常不是 Exception 子类，则 ExceptionGroup 构造函数将引发 TypeError。 异常组对于其所包含的异常的类型是通用的。 请注意，BaseExceptionGroup 定义了 __new__()，因此需要不同构造函数签名的子类需要重写它而不是 __init__()。例如，以下定义了一个异常组子类，它接受 exit_code 并从中构造该组的消息。 与 ExceptionGroup 一样，BaseExceptionGroup 的任何子类（也是 Exception 的子类）只能包装 Exception 的实例。

尝试创建已存在的文件或目录时引发。对应于 errno EEXIST。

当请求文件或目录但不存在时引发。对应于 errno ENOENT。

目前未使用。

有关已弃用功能的警告的基类，当这些警告针对的是用 Python 编写的应用程序的最终用户时。

ImportError 的子类，当延迟导入失败时引发，因为它（直接或间接）尝试导入自身。

当 import 语句尝试加载模块时遇到问题时引发。当 from ... import 中的“from list”具有无法找到的名称时也会引发。 可选的名称和路径关键字参数设置相应的属性：

有关模块导入中可能出现的错误的警告的基类。 被默认警告过滤器忽略。启用 Python 开发模式会显示此警告。

与不正确缩进相关的语法错误的基类。这是 SyntaxError 的子类。

当序列下标超出范围时引发。 （切片索引会被静默截断以落在允许的范围内；如果索引不是整数，则会引发 TypeError。）

当系统调用被传入信号中断时引发。对应于 errno EINTR。

当对目录请求文件操作（例如 os.remove()）时引发。对应于 errno EISDIR。

当在现有键集中找不到映射（字典）键时引发。

当映射或序列上使用的键或索引无效时引发的异常的基类：IndexError、KeyError。这可以直接由 codecs.lookup() 引发。

当操作耗尽内存但情况仍然可以挽救（通过删除一些对象）时引发。关联值是一个字符串，指示哪种（内部）操作耗尽了内存。请注意，由于底层内存管理架构（C 的 malloc() 函数）的原因，解释器可能并不总是能够从这种情况中完全恢复；尽管如此，它还是会引发异常，以便在程序失控的情况下打印堆栈回溯。

ImportError 的子类，当无法找到模块时由 import 引发。当 sys.modules 中找不到 None 时也会引发该错误。

当未找到本地或全局名称时引发。这仅适用于不合格的名称。关联值是一条错误消息，其中包含无法找到的名称。 可选的 name 仅关键字参数设置属性：

当对非目录的内容请求目录操作（例如 os.listdir()）时引发。在大多数 POSIX 平台上，如果操作尝试打开或遍历非目录文件（就像它是目录一样），也可能会引发该错误。对应于 errno ENOTDIR。

该异常源自 RuntimeError。在用户定义的基类中，当抽象方法需要派生类重写该方法时，或者在开发该类以指示仍需要添加真正的实现时，应该引发此异常。

当系统函数返回与系统相关的错误时，包括 I/O 故障，例如“文件未找到”或“磁盘已满”（不适用于非法参数类型或其他偶然错误），则会引发此异常。 构造函数的第二种形式设置相应的属性，如下所述。如果未指定，属性默认为 None。为了向后兼容，如果传递三个参数，则 args 属性仅包含前两个构造函数参数的 2 元组。 构造函数通常实际上返回 OSError 的子类，如下面的操作系统异常中所述。特定的子类取决于最终的 errno 值。此行为仅在直接或通过别名构造 OSError 时发生，并且在子类化时不会继承。

当算术运算的结果太大而无法表示时引发。对于整数来说，这种情况不会发生（这宁愿引发 MemoryError 而不是放弃）。但是，由于历史原因，有时会因超出所需范围的整数而引发 OverflowError。由于 C 语言中浮点异常处理缺乏标准化，因此大多数浮点运算都不会被检查。

有关已过时且预计将来会弃用但目前尚未弃用的功能的警告的基类。 此类很少使用，因为发出有关可能即将发生的弃用的警告是不寻常的，并且 DeprecationWarning 对于已经处于活动状态的弃用而言是首选。 被默认警告过滤器忽略。启用 Python 开发模式会显示此警告。 PEP 387 中描述了弃用政策。

当尝试在没有足够访问权限（例如文件系统权限）的情况下运行操作时引发。对应于 errno EACCES、EPERM 和 ENOTCAPABLE。

当给定进程不存在时引发。对应于 errno ESRCH。