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

---

# Работа с ошибками

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

Иногда быстрее исправить ошибки самостоятельно и отправить патчи в Python, так как это упрощает процесс и требует меньшего количества людей. Узнайте, как [внести свой вклад](https://python-all.ru/3.10/bugs.html#contributing-to-python).

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

Если обнаружена ошибка в этой документации или есть предложение по улучшению, отправьте сообщение об ошибке в [трекер](https://python-all.ru/3.10/bugs.html#using-the-tracker). Если есть предложение по исправлению, включите его также.

Вы также можете открыть обсуждение на нашем [форуме Documentation Discourse](https://python-all.ru/3.10/bugs.html).

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

> **См. также**
>
> **[Ошибки в документации](https://python-all.ru/3.10/bugs.html)**
>
> Список ошибок в документации, которые были отправлены в трекер ошибок Python.
>
> **[Отслеживание ошибок](https://python-all.ru/3.10/bugs.html)**
>
> Обзор процесса, связанного с сообщением об улучшении в трекере.
>
> **[Помощь с документацией](https://python-all.ru/3.10/bugs.html)**
>
> Исчерпывающее руководство для желающих внести вклад в документацию Python.
>
> **[Переводы документации](https://python-all.ru/3.10/bugs.html)**
>
> Список страниц GitHub для перевода документации и их контактные лица.

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

Отчёты об ошибках для самого Python следует отправлять через трекер ошибок GitHub ([https://github.com/python/cpython/issues](https://python-all.ru/3.10/bugs.html)). Трекер ошибок GitHub предоставляет веб-форму, в которую можно ввести необходимую информацию и отправить её разработчикам.

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

Если проблема, о которой вы сообщаете, ещё не в списке, войдите в GitHub. Если у вас ещё нет учётной записи GitHub, создайте новую с помощью ссылки «Sign up». Невозможно отправить отчёт об ошибке анонимно.

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

Форма отправки содержит два поля: «Title» и «Comment».

Для поля «Title» введите *очень* краткое описание проблемы; менее десяти слов – хорошо.

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

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

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

## Начало работы над собственным вкладом в Python

Вы можете не только сообщать об обнаруженных ошибках, но и отправлять исправления для их устранения. Дополнительную информацию о том, как начать вносить исправления в Python, можно найти в [Python Developer’s Guide](https://python-all.ru/3.10/bugs.html). Если у вас возникнут вопросы, [список рассылки core-mentorship](https://python-all.ru/3.10/bugs.html) – это дружелюбное место, где можно получить ответы на любые вопросы, касающиеся процесса исправления ошибок в Python.