> **Источник:** https://python-all.ru/3.2/bugs.html
>
> «Документация Python на русском» – неофициальный перевод официальной документации Python: версии от 2.6 до 3.16, полнотекстовый поиск, английский оригинал рядом с переводом. Эта Markdown-версия страницы предназначена для работы с LLM: вставьте её в ChatGPT, Claude или Cursor.

---

# Сообщение об ошибках

Python – зрелый язык программирования, завоевавший репутацию стабильности. Чтобы поддерживать эту репутацию, разработчики хотели бы знать обо всех недостатках, которые вы находите в Python.

## Ошибки в документации

Если вы нашли ошибку в этой документации или хотите предложить улучшение, пожалуйста, отправьте электронное письмо на [docs@python.org](https://python-all.ru/3.2/bugs.html) с описанием ошибки и места, где вы её нашли. Если у вас есть предложение по её исправлению, включите его тоже.

[docs@python.org](https://python-all.ru/3.2/bugs.html) – это список рассылки, поддерживаемый волонтёрами; ваш запрос будет замечен, даже если его обработка займёт некоторое время.

Конечно, если вы хотите сохранить более постоянную запись вашей проблемы, вы также можете использовать трекер ошибок для документации.

## Использование трекера ошибок Python

Отчёты об ошибках в самом Python следует отправлять через Python Bug Tracker ([http://bugs.python.org/](https://python-all.ru/3.2/bugs.html)). Трекер ошибок предоставляет веб-форму, позволяющую ввести соответствующие данные и отправить их разработчикам.

Первым шагом при отправке отчёта является проверка, не сообщалось ли уже об этой проблеме. Преимущество этого подхода, помимо экономии времени разработчиков, в том, что вы узнаёте, что было сделано для её исправления; возможно, проблема уже исправлена в следующем выпуске, или требуются дополнительные сведения (в этом случае вы можете их предоставить, если сможете!). Чтобы это сделать, воспользуйтесь поиском по базе ошибок в поле поиска в верхней части страницы.

Если проблема, о которой вы сообщаете, ещё не зарегистрирована в трекере, вернитесь в Python Bug Tracker и войдите в систему. Если у вас ещё нет учётной записи в трекере, выберите ссылку «Register» или, если вы используете OpenID, один из логотипов провайдера OpenID на боковой панели. Отправить сообщение об ошибке анонимно невозможно.

Теперь, когда вы вошли в систему, вы можете отправить сообщение об ошибке. Выберите ссылку «Create New» на боковой панели, чтобы открыть форму отправки сообщения об ошибке.

Форма отправки содержит несколько полей. В поле «Title» введите *очень* краткое описание проблемы; хорошо, если оно будет менее десяти слов. В поле «Type» выберите тип проблемы; также выберите «Component» и «Versions», к которым относится ошибка.

В поле «Comment» подробно опишите проблему, включая то, что вы oжидали и что произошло. Обязательно укажите, были ли задействованы какие-либо модули расширения, и какую аппаратную и программную платформу вы использовали (включая информацию о версиях, если необходимо).

Каждое сообщение об ошибке будет назначено разработчику, который определит, что необходимо сделать для исправления проблемы. Вы будете получать уведомление каждый раз, когда будут выполняться действия по ошибке.

> **См. также**
>
> **[Руководство разработчика Python](https://python-all.ru/3.2/devguide/index.html)**
>
> Подробное описание рабочего процесса обработки ошибок и инструментов разработчиков.
>
> **[Как эффективно сообщать об ошибках](https://python-all.ru/3.2/bugs.html)**
>
> Статья, которая подробно описывает, как составить полезный отчёт об ошибке. В ней объясняется, какая информация полезна и почему.
>
> **[Рекомендации по написанию отчётов об ошибках](https://python-all.ru/3.2/bugs.html)**
>
> Информация о том, как написать хороший отчёт об ошибке. Некоторые моменты относятся к проекту Mozilla, но описываются общие хорошие практики.
