Ошибка «python is not recognized as an internal or external command» после распаковки архива Windows embeddable package (64-bit) — самый частый симптом, с которым сталкиваются пользователи, впервые попробовавшие портативную сборку Python. Причина почти всегда одна: embeddable-пакет по умолчанию не прописывает себя в переменную PATH и не регистрируется в системе, поэтому командная строка его просто не видит.
В этой статье разберём, что представляет собой Windows embeddable package 64-bit, чем он отличается от обычного установщика Python, как правильно его распаковать, активировать поддержку pip и в каких сценариях портативная сборка действительно удобна. Инструкция актуальна для 64-разрядных версий Windows 10 и 11.
Что такое Windows embeddable package (64-bit)
Embeddable package — это минимальная сборка интерпретатора Python, распространяемая в виде ZIP-архива на официальном сайте python.org в разделе загрузок для Windows. В отличие от классического установщика executable installer, архив не требует прав администратора, не вносит записей в реестр и не создаёт ярлыков в меню «Пуск».
Внутри архива находятся исполняемый файл python.exe, стандартная библиотека в сжатом виде (python3xx.zip), файл конфигурации окружения python3xx._pth и базовые DLL. Этого достаточно, чтобы запускать скрипты, но недостаточно для полноценной разработки «из коробки» — например, pip в комплект не входит.
Чем embeddable-версия отличается от обычного установщика
Выбор между портативным архивом и стандартным инсталлятором зависит от задачи. Таблица ниже показывает ключевые различия двух вариантов распространения Python для Windows.
| Критерий | Embeddable package (64-bit) | Обычный установщик |
|---|---|---|
| Установка | Распаковка ZIP-архива | Запуск .exe с мастером установки |
| Права администратора | Не требуются | Часто требуются |
| pip из коробки | Отсутствует, нужно ставить вручную | Устанавливается автоматически |
| Записи в реестре и PATH | Не создаются | Создаются (опционально) |
| Назначение | Встраивание в приложения, портативность | Полноценная разработка |
Практический вывод простой: если вам нужна среда для ежедневной разработки, берите обычный установщик. Embeddable-сборка оправдана, когда интерпретатор нужно встроить в собственное приложение, запустить Python с флешки или развернуть на машине, где нет прав на установку ПО.
Где скачать и как проверить разрядность
Загружать архив следует только с официального сайта python.org: на странице релиза нужной версии Python в разделе Files найдите строку Windows embeddable package (64-bit). Рядом обычно присутствуют варианты (32-bit) и (ARM64) — не перепутайте их.
Проверить разрядность вашей системы можно через Параметры → Система → О системе, пункт «Тип системы». Если там указано «64-разрядная операционная система», скачивайте именно 64-bit архив. На 32-битной Windows 64-разрядный интерпретатор не запустится в принципе.
⚠️ Внимание: не скачивайте embeddable-пакеты со сторонних сайтов и «сборок». Под видом портативного Python в таких архивах могут распространяться вредоносные модули. Единственный надёжный источник — официальный раздел загрузок python.org.
Пошаговая установка и первый запуск
Установка портативной сборки сводится к аккуратной распаковке. Создайте отдельную папку, например C:\python-embed или каталог на флешке, и распакуйте туда содержимое ZIP-архива. Путь не должен содержать кириллицы и пробелов — это убережёт от части проблем с запуском скриптов.
Для проверки работоспособности откройте командную строку и выполните запуск с полным путём:
C:\python-embed\python.exe --versionЕсли в ответ выводится номер версии — интерпретатор работает. Чтобы не писать полный путь каждый раз, можно временно добавить папку в PATH в рамках текущей сессии командной строки:
set PATH=C:\python-embed;%PATH%☑️ Проверка после распаковки
Как включить pip в embeddable-сборке
Из коробки менеджер пакетов pip в архиве отсутствует, и попытка выполнить python -m pip завершится ошибкой No module named pip. Это нормальное поведение, а не признак битого архива. Установить pip можно скриптом get-pip.py.
Порядок действий такой: скачайте официальный скрипт get-pip.py, положите его в папку с распакованным Python и выполните команду python.exe get-pip.py. Затем откройте файл python3xx._pth в текстовом редакторе и раскомментируйте (или добавьте) строку import site — без этого установленные пакеты не будут подхватываться интерпретатором.
Зачем править файл python3xx._pth
Файл ._pth жёстко задаёт список путей поиска модулей и по умолчанию отключает механизм site-packages. Пока строка import site закомментирована, pip установит пакеты, но Python их не увидит. Это самая частая причина «пропадающих» библиотек в embeddable-сборке.
⚠️ Внимание: редактируйте
._pth-файл аккуратно и не удаляйте существующие строки с путями. Ошибка в этом файле приведёт к тому, что интерпретатор перестанет находить даже стандартную библиотеку.
Типичные проблемы и их решения
Ниже собраны ситуации, с которыми чаще всего сталкиваются пользователи портативной сборки. Большинство из них решается без переустановки.
- 🔧 «python is not recognized» — папка с интерпретатором не добавлена в
PATH; используйте полный путь кpython.exeили настройте переменную окружения. - 📦 «No module named pip» — pip не входит в архив; установите его через
get-pip.pyи включитеimport siteв._pth-файле. - 🚫 Ошибка при установке пакетов с компиляцией — часть библиотек требует компилятор; ищите готовые wheel-сборки под 64-bit Windows.
- 🔒 Блокировка антивирусом — портативные исполняемые файлы иногда вызывают ложные срабатывания; добавьте папку в исключения только если архив скачан с python.org.
- 🧩 Не подхватываются установленные модули — проверьте, раскомментирована ли строка
import siteв файлеpython3xx._pth.
Главное ограничение embeddable-сборки: она игнорирует системные переменные окружения Python и реестр, поэтому конфликты с уже установленным Python исключены — но и интеграции с системой (ассоциации файлов .py, запуск по двойному клику) придётся настраивать вручную.
Когда стоит выбрать обычный установщик
Портативная сборка — инструмент для конкретных сценариев, а не универсальная замена установщику. Если вы только начинаете изучать Python, планируете пользоваться IDLE, py launcher или интеграцией с редакторами вроде VS Code, стандартный executable installer сэкономит массу времени: он сам пропишет пути, установит pip и ассоциирует файлы.
Embeddable package оправдан, когда нужно распространять приложение вместе с интерпретатором, работать на компьютере без прав на установку или держать изолированную среду на съёмном носителе. В остальных случаях дополнительные шаги по настройке перевешивают преимущества портативности.
Частые вопросы
Можно ли запускать embeddable Python с флешки?
Да, это один из основных сценариев использования. Распакуйте архив в корень съёмного носителя и запускайте python.exe с указанием полного пути. Учтите, что буква диска на разных компьютерах может меняться, поэтому в скриптах лучше использовать относительные пути.
Почему pip не устанавливается даже после get-pip.py?
Наиболее вероятная причина — заблокированная строка import site в файле python3xx._pth. Откройте его в текстовом редакторе, удалите символ # перед этой строкой и повторите установку. Также проверьте, что скрипт get-pip.py скачан полностью и не повреждён.
Конфликтует ли embeddable package с установленным Python?
Нет. Портативная сборка изолирована: она не читает реестр и системные переменные, связанные с другими установками Python. Обе версии могут существовать на одном компьютере независимо друг от друга.
Чем 64-bit версия отличается от 32-bit в embeddable-архиве?
64-разрядная сборка работает только на 64-битной Windows и позволяет приложениям использовать больше оперативной памяти. 32-битный вариант нужен лишь для старых систем или для совместимости со специфическими 32-разрядными библиотеками.
Подходит ли embeddable package для изучения Python с нуля?
Технически — да, но неоптимально. Отсутствие pip, IDLE и автоматической настройки PATH создаёт лишние сложности на старте. Для обучения разумнее поставить обычный установщик с python.org, отметив при установке галочку добавления в PATH.