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

---

# 28.1. [`distutils`](https://python-all.ru/3.4/library/distutils.html#module-distutils) – Сборка и установка модулей Python

Пакет [`distutils`](https://python-all.ru/3.4/library/distutils.html#module-distutils) обеспечивает сборку и установку дополнительных модулей в дистрибутив Python. Новые модули могут быть либо полностью на Python, либо модулями расширения на C, либо наборами пакетов Python, включающими модули на Python и C.

Большинство пользователей Python *не* захотят использовать этот модуль напрямую, а вместо этого будут использовать кросс-версионные инструменты, поддерживаемые Python Packaging Authority. В частности, [setuptools](https://python-all.ru/3.4/library/distutils.html) – это расширенная альтернатива [`distutils`](https://python-all.ru/3.4/library/distutils.html#module-distutils), которая предоставляет:

- поддержка объявления зависимостей проекта
- дополнительные механизмы для настройки того, какие файлы включать в исходные релизы (включая плагины для интеграции с системами контроля версий)
- возможность объявлять «точки входа» проекта, которые могут использоваться как основа для систем плагинов приложений
- возможность автоматически генерировать исполняемые файлы командной строки Windows во время установки вместо необходимости предварительно их собирать
- единообразное поведение во всех поддерживаемых версиях Python

Рекомендуемый установщик [pip](https://python-all.ru/3.4/library/distutils.html) запускает все скрипты `setup.py` с `setuptools`, даже если сам скрипт импортирует только `distutils`. Дополнительную информацию см. в [Python Packaging User Guide](https://python-all.ru/3.4/library/distutils.html).

Для пользы авторов инструментов упаковки и пользователей, стремящихся к более глубокому пониманию деталей текущей системы упаковки и распространения, устаревшая документация пользователя, основанная на [`distutils`](https://python-all.ru/3.4/library/distutils.html#module-distutils), и справочник API остаются доступными:

- [*Установка модулей Python (устаревшая версия)*](https://python-all.ru/3.4/install/index.html#install-index)
- [*Распространение модулей Python (устаревшая версия)*](https://python-all.ru/3.4/distutils/index.html#distutils-index)
