Документация Python на русском: где читать

Официальная документация Python на русском находится по адресу docs.python.org/ru/3/. Это раздел официального сайта docs.python.org: русский язык выбирается в переключателе языков в шапке любой страницы. Полностью переведены учебник (Tutorial) и глоссарий, почти полностью — описание встроенных функций. Справочник по стандартной библиотеке, HOWTO и «Что нового» пока остаются на английском: непереведённые абзацы показываются в оригинале прямо на русской странице.

Ниже — что именно уже переведено, как устроены разделы Python docs, как пользоваться встроенной справкой help() и pydoc, где скачать документацию для работы без интернета и где искать документацию сторонних библиотек. Статус перевода проверен в октябре 2026 года.

Как открыть документацию Python на русском

Есть три способа попасть в русскую версию:

1. Открыть адрес docs.python.org/ru/3/ — это последняя стабильная версия Python, для которой собран перевод.
2. На любой странице английской документации выбрать «Russian | Русский» в списке языков в шапке. Откроется та же страница на русском.
3. Подставить в адрес код языка и номер версии: docs.python.org/ru/3.13/, docs.python.org/ru/3.12/. Английская версия живёт по адресам без кода языка: docs.python.org/3/, docs.python.org/3.13/.

Рядом с переключателем языков находится переключатель версий. Читайте документацию той версии Python, которая у вас установлена: функции, добавленные в 3.14, не заработают в 3.12. Узнать версию можно командой:

py --version        # Windows

python3 --version   # macOS и Linux

Подробнее о способах проверки — в статье как узнать версию Python.

Важно: русская версия может отставать от английской. В октябре 2026 года docs.python.org/3/ уже описывает Python 3.15, а docs.python.org/ru/3/ — Python 3.14. Номер версии указан в заголовке каждой страницы.

Что уже переведено на русский

Перевод делают волонтёры. Исходники лежат в репозитории python/python-docs-ru на GitHub, сам перевод ведётся на платформе Transifex. Прогресс всех языков публикуется на translations.python.org: в октябре 2026 года у русского перевода «ядро» (учебник, встроенные функции и страница об ошибках) переведено на 100 %, а вся документация — примерно на 5 %.

Состояние разделов в версии для Python 3.14:

Раздел	Перевод
Руководство (Tutorial)	полностью
Встроенные функции	почти полностью
Встроенные типы, исключения, константы	в основном на английском
Справочник по языку	лексический анализ и простые инструкции — полностью, модель данных — примерно на 60 %, выражения и составные инструкции — в основном на английском
Справочник по библиотеке (модули)	в основном на английском, переведены отдельные фрагменты
Глоссарий	полностью
HOWTO, FAQ, «Что нового», установка Python	на английском
Главная страница, меню, навигация	полностью

Для начинающего этого хватает, чтобы пройти официальный учебник и разбираться со встроенными функциями вроде print(), len() и sorted() на русском. Описание модулей стандартной библиотеки (json, os, datetime) пока придётся читать на английском или через переводчик браузера. Обзор самых нужных модулей на русском — в статье о стандартной библиотеке Python.

Старые ответы на форумах вроде «официального перевода нет» написаны до запуска проекта. Неофициальные полные переводы, которые там советуют, давно не обновлялись, а часть сайтов уже не открывается.

Как устроена документация Python

Главная страница docs.python.org делит документацию на разделы. Названия в русской версии приведены вместе с английскими — по ним удобнее искать.

Раздел	Что внутри	Когда открывать
Руководство (Tutorial)	последовательный курс по языку: от интерпретатора до классов, виртуальных окружений и модулей	первое знакомство с Python, если уже программировали на другом языке
Справочник по встроенным объектам (Built-ins reference)	встроенные функции, типы (str, list, dict), исключения, константы	узнать аргументы функции или методы строки и списка
Справочник по библиотеке (Library reference)	все модули стандартной библиотеки	работа с файлами, датами, JSON, сетью, потоками
Справочник по языку (Language reference)	формальное описание синтаксиса и модели данных	точные правила: как работает import, области видимости, магические методы
Практические руководства (HOWTOs)	тематические статьи: логирование, регулярные выражения, сортировка, asyncio	разобраться в теме глубже, чем в справочнике
Что нового (What’s New)	изменения каждой версии с примерами	перед обновлением Python или при переходе между версиями
Установка и использование Python (Python setup and usage)	установка на Windows, macOS и Linux, параметры командной строки	настройка интерпретатора и окружения
Установка модулей Python (Installing Python modules)	pip и PyPI	установка сторонних пакетов
ЧаВо (FAQs)	ответы на частые вопросы о языке и программировании	«почему так устроено» и типовые ошибки
Глоссарий	определения терминов: итератор, декоратор, GIL	встретили незнакомый термин

В конце главной страницы есть указатели: Глобальный указатель модулей — алфавитный список модулей, Общий указатель — все функции, классы и термины, и страница поиска.

В документации для Python 3.13 и новее встроенные функции и типы вынесены в отдельный раздел builtins/. Старые адреса вроде library/functions.html перенаправляют на новые, поэтому закладки и ссылки из старых статей продолжают работать.

Как читать сигнатуру функции

Сигнатура — первая строка описания функции, в ней перечислены параметры. Например, у sorted():

sorted(iterable, /, *, key=None, reverse=False)

• Параметры до / передаются только по позиции: sorted(words), а не sorted(iterable=words).
• Параметры после * передаются только по имени: key=str.lower.
• key=None — значение по умолчанию, такой аргумент можно не передавать.

words = ["banana", "Apple", "cherry"]
print(sorted(words, key=str.lower))                # → ['Apple', 'banana', 'cherry']
print(sorted(words, key=str.lower, reverse=True))  # → ['cherry', 'banana', 'Apple']
sorted(words, str.lower)

TypeError: sorted expected 1 argument, got 2

Отметки «Добавлено в версии 3.x» и «Изменено в версии 3.x» под описанием показывают, с какой версии работает функция или параметр. Если у вас Python старше указанного, этой возможностью воспользоваться не получится.

Как быстро найти нужное

• Знаете имя модуля — откройте указатель модулей и выберите его.
• Знаете имя функции или метода — ищите в общем указателе или через Ctrl+F на странице модуля.
• Не знаете, где искать, — воспользуйтесь поиском по документации или поисковиком с уточнением site:docs.python.org.

Встроенная справка: help() и pydoc

Документация к любой функции, классу или модулю доступна прямо в интерпретаторе. Функция help() показывает строку документации (docstring) объекта и его сигнатуру:

help(len)

Help on built-in function len in module builtins:

len(obj, /)
    Return the number of items in a container.

Справка выводится на английском: это строки документации из исходного кода Python, русский перевод сайта на них не влияет.

Другие полезные приёмы:

help("keywords")   # список ключевых слов Python
help("for")        # описание инструкции for из справочника по языку
print(len.__doc__)  # → Return the number of items in a container.
print([m for m in dir(str) if not m.startswith("_")][:5])
# → ['capitalize', 'casefold', 'center', 'count', 'encode']

dir() выводит список атрибутов и методов объекта, а help(str.split) — описание конкретного метода. Если вызвать help() без аргументов, откроется интерактивная справка; выход — q или пустая строка. В интерактивной оболочке Python 3.13 и новее справку открывает клавиша F1, а help можно вводить без скобок.

pydoc в командной строке

Тот же текст доступен без запуска интерпретатора через модуль pydoc:

py -m pydoc json          # справка по модулю json в терминале
py -m pydoc str.split     # справка по методу
py -m pydoc -b            # документация в браузере
py -m pydoc -w json       # сохранить справку в файл json.html

python3 -m pydoc json
python3 -m pydoc str.split
python3 -m pydoc -b
python3 -m pydoc -w json

Ключ -b запускает локальный сервер и открывает в браузере страницу со всеми установленными модулями — и стандартными, и сторонними из текущего окружения. Ключ -p 8080 запускает сервер на заданном порту без открытия браузера:

Server ready at http://localhost:8080/
Server commands: [b]rowser, [q]uit
server>

Остановить сервер — команда q. Редакторы кода показывают ту же строку документации при наведении на имя функции; настройка Python в редакторе описана в статье про VS Code для Python.

Документация Python офлайн

Полную документацию можно скачать со страницы «Скачать» (Download) — ссылка есть в боковой панели главной страницы. Доступны форматы:

• HTML в архивах .zip и .tar.bz2 — тот же сайт, открывается в браузере без интернета;
• обычный текст;
• Texinfo;
• EPUB — для читалок и телефона.

Готовых PDF на сайте больше нет: их собирают самостоятельно командой make dist-pdf в каталоге Doc/ исходников CPython. У русской версии своя страница загрузки (docs.python.org/ru/3/download.html) с архивами перевода.

Документация уже может лежать на вашем компьютере:

• Windows. Установщик с python.org ставит HTML-документацию, если отмечен компонент Documentation (параметр Include_doc). Файлы лежат в папке Doc\html внутри каталога Python.
• Debian и Ubuntu. Документация ставится отдельным пакетом и появляется в /usr/share/doc/python3.X/html/, где X — минорная версия:

sudo apt install python3-doc

Встроенные help() и pydoc -b работают без интернета всегда.

Документация сторонних библиотек: PyPI и Read the Docs

docs.python.org описывает только сам язык и стандартную библиотеку. Документация Django, requests, pandas и других пакетов живёт на сайтах этих проектов. Найти её проще всего через PyPI — каталог пакетов Python на pypi.org:

1. Найдите пакет на PyPI.
2. В боковой панели в блоке Project links откройте ссылку Documentation. Если её нет, смотрите описание проекта (README) на той же странице и ссылку на репозиторий.

Многие проекты размещают документацию на Read the Docs — адреса вида имя-проекта.readthedocs.io. Там тоже есть переключатель версий: выберите ту, что установлена у вас.

Ссылку на документацию уже установленного пакета показывает pip с ключом -v:

py -m pip show -v requests        # Windows

python3 -m pip show -v requests   # macOS и Linux

Name: requests
Version: 2.34.2
...
Project-URLs:
  Documentation, https://requests.readthedocs.io
  Source, https://github.com/psf/requests

Строка Version подсказывает, какую версию документации открывать. Как ставить и обновлять пакеты, рассказано в статье как установить библиотеку в Python.

Частые вопросы

Можно ли скачать документацию Python в PDF?

Готовых PDF-файлов на docs.python.org больше нет. Для чтения на телефоне или в читалке скачайте EPUB, для компьютера — архив HTML. PDF можно собрать самостоятельно из исходников CPython по инструкции из Python Developer’s Guide.

Как помочь с переводом документации?

Перевод ведётся на Transifex в проекте python-doc: зарегистрируйтесь и вступите в русскую команду. На каждой странице русской версии есть ссылки «Сообщить об ошибке» и «Улучшить эту страницу». Описание процесса — в README репозитория python/python-docs-ru.

Подойдёт ли переводчик браузера для английской документации?

Для разделов без перевода — да, текст будет понятен. Названия функций, параметров и модулей сверяйте с оригиналом: машинный перевод иногда переводит их как обычные слова.

Чем документация отличается от PEP?

Документация описывает, как язык и библиотека работают сейчас. PEP (Python Enhancement Proposal) — предложение об изменении языка с обоснованием и обсуждением. Читать PEP полезно, чтобы понять, почему возможность устроена именно так; PEP 8 — общепринятый стиль кода, его стоит знать с самого начала.

Есть ли документация Django на русском?

Django документируется отдельно на своём сайте. Где читать её на русском и насколько полон перевод — в статье документация Django на русском.

С чего начать новичку, если английский учебник кажется сложным?

Официальный учебник рассчитан на тех, кто уже программировал на другом языке. Если вы начинаете с нуля, возьмите курс или книгу и возвращайтесь к документации за подробностями: подборка — в статье книги по Python для начинающих, а краткий обзор основ — в шпаргалке по синтаксису Python.

Итог

• Официальная документация Python на русском — docs.python.org/ru/3/, язык выбирается переключателем в шапке.
• Переведены учебник, встроенные функции, глоссарий и часть справочника по языку; модули стандартной библиотеки, HOWTO и «Что нового» пока на английском.
• Русская версия может отставать по номеру Python — сверяйте версию в заголовке с установленной.
• Для быстрых подсказок используйте help(), dir() и python -m pydoc -b, они работают без интернета.
• Офлайн-копию в HTML или EPUB скачивайте со страницы загрузки; на Windows она может уже лежать в Doc\html.
• Документацию сторонних пакетов ищите на PyPI в Project links или через pip show -v.

Документация отвечает на вопрос «как это работает», а навыки приходят с практикой. Если вы только начинаете, посмотрите план изучения Python с нуля.