exceptions.md
1> **Источник:** https://python-all.ru/3.2/library/exceptions.html2>3> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.45---67# 5. Встроенные исключения89В Python все исключения должны быть экземплярами класса, наследующего от [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException). В инструкции [`try`](https://python-all.ru/3.2/reference/compound_stmts.html#try) с блоком [`except`](https://python-all.ru/3.2/reference/compound_stmts.html#except), в котором указан конкретный класс, этот блок также обрабатывает любые исключения, являющиеся подклассами этого класса (но не классы исключений, от которых *он* наследуется). Два класса исключений, не связанные отношением наследования, никогда не эквивалентны, даже если у них одинаковые имена.1011Перечисленные ниже встроенные исключения могут быть созданы интерпретатором или встроенными функциями. За исключением особо оговоренных случаев, они имеют «связанное значение», указывающее на детальную причину ошибки. Это может быть строка или кортеж из нескольких элементов информации (например, код ошибки и строка, поясняющая код). Связанное значение обычно передаётся в качестве аргументов конструктору класса исключения.1213Пользовательский код может возбуждать встроенные исключения. Это можно использовать для проверки обработчика исключений или для сообщения об ошибке «точно так же», как если бы интерпретатор возбудил то же самое исключение; однако следует помнить, что ничто не мешает пользовательскому коду возбудить неподходящую ошибку.1415Встроенные классы исключений можно наследовать для определения новых исключений; программистам рекомендуется, по крайней мере, выводить новые исключения из класса [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception), а не [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException). Дополнительную информацию об определении исключений можно найти в учебнике Python в разделе [*Пользовательские исключения*](https://python-all.ru/3.2/tutorial/errors.html#tut-userexceptions).1617Следующие исключения в основном используются как базовые классы для других исключений.1819#### `exception BaseException`2021Базовый класс для всех встроенных исключений. Он не предназначен для прямого наследования пользовательскими классами (для этого используйте [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception)). Если на экземпляре этого класса вызвать [`str()`](https://python-all.ru/3.2/library/functions.html#str), возвращается представление аргумента (аргументов), переданных экземпляру, или пустая строка, если аргументов не было.2223#### `args`2425Кортеж аргументов, переданных конструктору исключения. Некоторые встроенные исключения (например, [`IOError`](https://python-all.ru/3.2/library/exceptions.html#IOError)) ожидают определённое количество аргументов и придают особое значение элементам этого кортежа, в то время как другие обычно вызываются только с одной строкой, содержащей сообщение об ошибке.2627#### `with_traceback(tb)`2829Этот метод устанавливает *tb* в качестве новой трассировки для исключения и возвращает объект исключения. Обычно используется в коде обработки исключений, например:3031```python32try:33 ...34except SomeException:35 tb = sys.exc_info()[2]36 raise OtherException(...).with_traceback(tb)37```3839#### `exception Exception`4041Все встроенные исключения, не приводящие к завершению системы, являются производными от этого класса. Все определённые пользователем исключения также должны наследоваться от этого класса.4243#### `exception ArithmeticError`4445Базовый класс для тех встроенных исключений, которые возбуждаются при различных арифметических ошибках: [`OverflowError`](https://python-all.ru/3.2/library/exceptions.html#OverflowError), [`ZeroDivisionError`](https://python-all.ru/3.2/library/exceptions.html#ZeroDivisionError), [`FloatingPointError`](https://python-all.ru/3.2/library/exceptions.html#FloatingPointError).4647#### `exception BufferError`4849Возбуждается, когда не может быть выполнена операция, связанная с [*буфером*](https://python-all.ru/3.2/c-api/buffer.html#bufferobjects).5051#### `exception LookupError`5253Базовый класс для исключений, которые возбуждаются, когда ключ или индекс, используемые в отображении или последовательности, недопустимы: [`IndexError`](https://python-all.ru/3.2/library/exceptions.html#IndexError), [`KeyError`](https://python-all.ru/3.2/library/exceptions.html#KeyError). Это исключение может быть возбуждено напрямую функцией [`codecs.lookup()`](https://python-all.ru/3.2/library/codecs.html#codecs.lookup).5455#### `exception EnvironmentError`5657The base class for exceptions that can occur outside the Python system: [`IOError`](https://python-all.ru/3.2/library/exceptions.html#IOError), [`OSError`](https://python-all.ru/3.2/library/exceptions.html#OSError). When exceptions of this type are created with a 2-tuple, the first item is available on the instance’s [`errno`](https://python-all.ru/3.2/library/errno.html#module-errno) attribute (it is assumed to be an error number), and the second item is available on the `strerror` attribute (it is usually the associated error message). The tuple itself is also available on the `args` attribute.5859Когда исключение [`EnvironmentError`](https://python-all.ru/3.2/library/exceptions.html#EnvironmentError) создаётся с кортежем из трёх элементов, первые два элемента доступны, как описано выше, а третий элемент – в атрибуте `filename`. Однако для обратной совместимости атрибут `args` содержит только кортеж из двух первых аргументов конструктора.6061The `filename` attribute is `None` when this exception is created with other than 3 arguments. The [`errno`](https://python-all.ru/3.2/library/errno.html#module-errno) and `strerror` attributes are also `None` when the instance was created with other than 2 or 3 arguments. In this last case, `args` contains the verbatim constructor arguments as a tuple.6263Обычно возбуждаются следующие исключения.6465#### `exception AssertionError`6667Возбуждается, когда инструкция [`assert`](https://python-all.ru/3.2/reference/simple_stmts.html#assert) завершается неудачей.6869#### `exception AttributeError`7071Возбуждается, когда обращение к атрибуту (см. [*Обращения к атрибутам*](https://python-all.ru/3.2/reference/expressions.html#attribute-references)) или присваивание атрибута завершается неудачей. (Если объект вообще не поддерживает обращение к атрибутам или их присваивание, возбуждается [`TypeError`](https://python-all.ru/3.2/library/exceptions.html#TypeError).)7273#### `exception EOFError`7475Возникает, когда одна из встроенных функций ([`input()`](https://python-all.ru/3.2/library/functions.html#input) или `raw_input()`) достигает состояния конца файла (EOF), не прочитав никаких данных. (Примечание: методы `file.read()` и `file.readline()` возвращают пустую строку при достижении EOF.)7677#### `exception FloatingPointError`7879Возбуждается при сбое операции с плавающей точкой. Это исключение определено всегда, но может быть возбуждено только если Python скомпилирован с опцией `--with-fpectl`, или символ `WANT_SIGFPE_HANDLER` определён в файле `pyconfig.h`.8081#### `exception GeneratorExit`8283Возбуждается при вызове метода `close()` у [*генератора*](https://python-all.ru/3.2/glossary.html#term-generator). Он напрямую наследуется от [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException), а не от [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception), поскольку технически не является ошибкой.8485#### `exception IOError`8687Возникает, когда операция ввода-вывода (такая как встроенные функции [`print()`](https://python-all.ru/3.2/library/functions.html#print) или [`open()`](https://python-all.ru/3.2/library/functions.html#open), или метод [*объекта файла*](https://python-all.ru/3.2/glossary.html#term-file-object)) завершается неудачей по причине, связанной с вводом-выводом, например, «файл не найден» или «диск переполнен».8889Этот класс является производным от [`EnvironmentError`](https://python-all.ru/3.2/library/exceptions.html#EnvironmentError). См. обсуждение выше для получения дополнительной информации об атрибутах экземпляров исключений.9091#### `exception ImportError`9293Возбуждается, когда инструкция [`import`](https://python-all.ru/3.2/reference/simple_stmts.html#import) не может найти определение модуля, или когда конструкция `from ... import` не может найти имя, которое должно быть импортировано.9495#### `exception IndexError`9697Вызывается, когда индекс последовательности выходит за пределы диапазона. (Индексы срезов молча усекаются до допустимого диапазона; если индекс не является целым числом, вызывается [`TypeError`](https://python-all.ru/3.2/library/exceptions.html#TypeError).)9899#### `exception KeyError`100101Вызывается, когда ключ отображения (словаря) не найден среди существующих ключей.102103#### `exception KeyboardInterrupt`104105Вызывается, когда пользователь нажимает клавишу прерывания (обычно `Control-C` или `Delete`). Во время выполнения регулярно проверяется наличие прерываний. Исключение наследуется от [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException), чтобы случайно не быть перехваченным кодом, который ловит [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception), и тем самым не помешать выходу интерпретатора.106107#### `exception MemoryError`108109Вызывается, когда у операции заканчивается память, но ситуация всё ещё может быть исправлена (удалением некоторых объектов). Связанное значение – строка, указывающая, какая (внутренняя) операция исчерпала память. Обратите внимание, что из-за особенностей архитектуры управления памятью (функция `malloc()` в C) интерпретатор не всегда может полностью восстановиться после такой ситуации; тем не менее, он вызывает исключение, чтобы можно было вывести трассировку стека, если причиной была вышедшая из-под контроля программа.110111#### `exception NameError`112113Вызывается, когда не найдено локальное или глобальное имя. Это относится только к неквалифицированным именам. Связанное значение – сообщение об ошибке, которое включает имя, которое не удалось найти.114115#### `exception NotImplementedError`116117Это исключение происходит от [`RuntimeError`](https://python-all.ru/3.2/library/exceptions.html#RuntimeError). В пользовательских базовых классах абстрактные методы должны вызывать это исключение, когда они требуют от производных классов переопределить метод.118119#### `exception OSError`120121Это исключение является производным от [`EnvironmentError`](https://python-all.ru/3.2/library/exceptions.html#EnvironmentError). Оно возникает, когда функция возвращает системную ошибку (не из-за недопустимых типов аргументов или других случайных ошибок). Атрибут [`errno`](https://python-all.ru/3.2/library/errno.html#module-errno) содержит числовой код ошибки из `errno`, а атрибут `strerror` – соответствующую строку, какую бы вывела функция C `perror()`. См. модуль [`errno`](https://python-all.ru/3.2/library/errno.html#module-errno), который содержит имена кодов ошибок, определённых базовой операционной системой.122123Для исключений, связанных с путём файловой системы (например, `chdir()` или `unlink()`), экземпляр исключения будет содержать третий атрибут, `filename`, который является именем файла, переданным функции.124125#### `exception OverflowError`126127Возбуждается, когда результат арифметической операции слишком велик для представления. Это не может произойти для целых чисел (которые скорее возбудят [`MemoryError`](https://python-all.ru/3.2/library/exceptions.html#MemoryError), чем сдадутся). Из-за отсутствия стандартизации обработки исключений с плавающей запятой в C большинство операций с плавающей запятой также не проверяются.128129#### `exception ReferenceError`130131Это исключение вызывается, когда прокси слабой ссылки, созданный функцией [`weakref.proxy()`](https://python-all.ru/3.2/library/weakref.html#weakref.proxy), используется для доступа к атрибуту объекта после его сборки мусора. Для получения дополнительной информации о слабых ссылках см. модуль [`weakref`](https://python-all.ru/3.2/library/weakref.html#module-weakref).132133#### `exception RuntimeError`134135Возникает, когда обнаружена ошибка, не подпадающая ни под одну из других категорий. Связанное значение – это строка, указывающая, что именно пошло не так. (Это исключение в основном является пережитком предыдущей версии интерпретатора; сейчас оно используется нечасто.)136137#### `exception StopIteration`138139Возникает, когда встроенная функция [`next()`](https://python-all.ru/3.2/library/functions.html#next) или метод [`__next__()`](https://python-all.ru/3.2/library/stdtypes.html#iterator.__next__) [*итератора*](https://python-all.ru/3.2/glossary.html#term-iterator) сигнализируют об отсутствии дальнейших значений.140141#### `exception SyntaxError`142143Возбуждается, когда синтаксический анализатор обнаруживает синтаксическую ошибку. Это может произойти в операторе [`import`](https://python-all.ru/3.2/reference/simple_stmts.html#import), при вызове встроенных функций [`exec()`](https://python-all.ru/3.2/library/functions.html#exec) или [`eval()`](https://python-all.ru/3.2/library/functions.html#eval), а также при чтении начального скрипта или стандартного ввода (в том числе в интерактивном режиме).144145Экземпляры этого класса имеют атрибуты `filename`, `lineno`, `offset` и `text` для удобного доступа к подробностям. [`str()`](https://python-all.ru/3.2/library/functions.html#str) от экземпляра исключения возвращает только сообщение.146147#### `exception IndentationError`148149Базовый класс для синтаксических ошибок, связанных с неправильным отступом. Является подклассом [`SyntaxError`](https://python-all.ru/3.2/library/exceptions.html#SyntaxError).150151#### `exception TabError`152153Возбуждается, когда в отступах используется непоследовательное сочетание табуляции и пробелов. Является подклассом [`IndentationError`](https://python-all.ru/3.2/library/exceptions.html#IndentationError).154155#### `exception SystemError`156157Возникает, когда интерпретатор обнаруживает внутреннюю ошибку, но ситуация не настолько серьезна, чтобы заставить его отказаться от всех надежд. Связанное значение представляет собой строку, указывающую на то, что пошло не так (на низкоуровневом языке).158159Сообщите об этом автору или сопровождающему вашего интерпретатора Python. Обязательно укажите версию интерпретатора Python (`sys.version`; она также выводится в начале интерактивного сеанса Python), точное сообщение об ошибке (связанное значение исключения) и, если возможно, исходный код программы, вызвавшей ошибку.160161#### `exception SystemExit`162163Это исключение возбуждается функцией [`sys.exit()`](https://python-all.ru/3.2/library/sys.html#sys.exit). Если оно не обработано, интерпретатор Python завершает работу; трассировка стека не выводится. Если связанное значение является целым числом, оно задаёт статус выхода системы (передаётся функции C `exit()`); если это `None`, статус выхода равен нулю; если оно имеет другой тип (например, строку), значение объекта выводится, а статус выхода равен единице.164165Экземпляры имеют атрибут [`code`](https://python-all.ru/3.2/library/code.html#module-code), который устанавливается в предлагаемый код завершения или сообщение об ошибке (по умолчанию `None`). Кроме того, это исключение наследуется напрямую от [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException), а не от [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception), поскольку технически это не ошибка.166167Вызов [`sys.exit()`](https://python-all.ru/3.2/library/sys.html#sys.exit) преобразуется в исключение, чтобы обработчики очистки (предложения [`finally`](https://python-all.ru/3.2/reference/compound_stmts.html#finally) операторов [`try`](https://python-all.ru/3.2/reference/compound_stmts.html#try)) могли выполниться, и чтобы отладчик мог выполнить сценарий, не рискуя потерять управление. Функцию [`os._exit()`](https://python-all.ru/3.2/library/os.html#os._exit) можно использовать, если абсолютно необходимо выйти немедленно (например, в дочернем процессе после вызова `fork()`).168169Исключение наследуется от [`BaseException`](https://python-all.ru/3.2/library/exceptions.html#BaseException), а не от [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception), чтобы оно случайно не перехватывалось кодом, который ловит [`Exception`](https://python-all.ru/3.2/library/exceptions.html#Exception). Это позволяет исключению правильно всплывать и приводить к завершению интерпретатора.170171#### `exception TypeError`172173Вызывается, когда операция или функция применяется к объекту неподходящего типа. Связанное значение – строка с подробностями о несоответствии типов.174175#### `exception UnboundLocalError`176177Возбуждается при обращении к локальной переменной в функции или методе, которой не присвоено значение. Является подклассом [`NameError`](https://python-all.ru/3.2/library/exceptions.html#NameError).178179#### `exception UnicodeError`180181Возбуждается при возникновении ошибки кодирования или декодирования, связанной с Unicode. Является подклассом [`ValueError`](https://python-all.ru/3.2/library/exceptions.html#ValueError).182183#### `exception UnicodeEncodeError`184185Возникает при ошибке, связанной с Unicode, во время кодирования. Является подклассом [`UnicodeError`](https://python-all.ru/3.2/library/exceptions.html#UnicodeError).186187#### `exception UnicodeDecodeError`188189Возникает при ошибке, связанной с Unicode, во время декодирования. Является подклассом [`UnicodeError`](https://python-all.ru/3.2/library/exceptions.html#UnicodeError).190191#### `exception UnicodeTranslateError`192193Возникает при ошибке, связанной с Unicode, во время трансляции. Является подклассом [`UnicodeError`](https://python-all.ru/3.2/library/exceptions.html#UnicodeError).194195#### `exception ValueError`196197Возникает, когда встроенная операция или функция получает аргумент правильного типа, но с неподходящим значением, и эта ситуация не описывается более точным исключением, например [`IndexError`](https://python-all.ru/3.2/library/exceptions.html#IndexError).198199#### `exception VMSError`200201Доступно только в VMS. Возникает, когда происходит специфичная для VMS ошибка.202203#### `exception WindowsError`204205Возникает, когда происходит специфичная для Windows ошибка или когда номер ошибки не соответствует значению `errno`. Значения `winerror` и `strerror` создаются из возвращаемых значений функций `GetLastError()` и `FormatMessage()` из Windows Platform API. Значение [`errno`](https://python-all.ru/3.2/library/errno.html#module-errno) отображает значение `winerror` в соответствующие значения `errno.h`. Это подкласс [`OSError`](https://python-all.ru/3.2/library/exceptions.html#OSError).206207#### `exception ZeroDivisionError`208209Вызывается, когда второй аргумент операции деления или взятия остатка равен нулю. Связанное значение – строка, указывающая тип операндов и операцию.210211Следующие исключения используются в качестве категорий предупреждений; подробнее см. в модуле [`warnings`](https://python-all.ru/3.2/library/warnings.html#module-warnings).212213#### `exception Warning`214215Базовый класс для категорий предупреждений.216217#### `exception UserWarning`218219Базовый класс для предупреждений, генерируемых пользовательским кодом.220221#### `exception DeprecationWarning`222223Базовый класс для предупреждений об устаревших возможностях.224225#### `exception PendingDeprecationWarning`226227Базовый класс для предупреждений о возможностях, которые будут признаны устаревшими в будущем.228229#### `exception SyntaxWarning`230231Базовый класс для предупреждений о сомнительном синтаксисе.232233#### `exception RuntimeWarning`234235Базовый класс для предупреждений о сомнительном поведении во время выполнения.236237#### `exception FutureWarning`238239Базовый класс для предупреждений о конструкциях, которые в будущем изменят семантику.240241#### `exception ImportWarning`242243Базовый класс для предупреждений о возможных ошибках при импорте модулей.244245#### `exception UnicodeWarning`246247Базовый класс для предупреждений, связанных с Unicode.248249#### `exception BytesWarning`250251Базовый класс для предупреждений, связанных с [`bytes`](https://python-all.ru/3.2/library/functions.html#bytes) и `buffer`.252253#### `exception ResourceWarning`254255Базовый класс для предупреждений, связанных с использованием ресурсов.256257Новое в версии 3.2.258259## 5.1. Иерархия исключений260261Иерархия классов для встроенных исключений:262263```python264BaseException265 +-- SystemExit266 +-- KeyboardInterrupt267 +-- GeneratorExit268 +-- Exception269 +-- StopIteration270 +-- ArithmeticError271 | +-- FloatingPointError272 | +-- OverflowError273 | +-- ZeroDivisionError274 +-- AssertionError275 +-- AttributeError276 +-- BufferError277 +-- EnvironmentError278 | +-- IOError279 | +-- OSError280 | +-- WindowsError (Windows)281 | +-- VMSError (VMS)282 +-- EOFError283 +-- ImportError284 +-- LookupError285 | +-- IndexError286 | +-- KeyError287 +-- MemoryError288 +-- NameError289 | +-- UnboundLocalError290 +-- ReferenceError291 +-- RuntimeError292 | +-- NotImplementedError293 +-- SyntaxError294 | +-- IndentationError295 | +-- TabError296 +-- SystemError297 +-- TypeError298 +-- ValueError299 | +-- UnicodeError300 | +-- UnicodeDecodeError301 | +-- UnicodeEncodeError302 | +-- UnicodeTranslateError303 +-- Warning304 +-- DeprecationWarning305 +-- PendingDeprecationWarning306 +-- RuntimeWarning307 +-- SyntaxWarning308 +-- UserWarning309 +-- FutureWarning310 +-- ImportWarning311 +-- UnicodeWarning312 +-- BytesWarning313 +-- ResourceWarning314```315