Устранение ошибок установки Python

Раздел: Настройка -> Установка и настройка окружения

Основные причины и решения

Наиболее часто ошибки при установке Python возникают из-за неверно выбранного установщика, отсутствия прав администратора или неучтённых зависимостей. Универсальным решением является загрузка официального установщика с python.org и его запуск с правами администратора. При установке обязательно отмечается пункт Add Python to PATH, что позволяет использовать команды python и pip из любой директории терминала.

Шаг 1: перейти на официальный сайт python.org/downloads и скачать установщик для своей операционной системы (Windows, macOS, Linux).

Шаг 2: запустить установщик от имени администратора (правой кнопкой мыши -> Запуск от имени администратора).

Шаг 3: выбрать опцию Customize installation (пользовательская установка) для контроля компонентов, либо оставить по умолчанию. Убедиться, что включены: pip, py launcher, а также выбрано "Add Python to PATH".

Шаг 4: указать каталог установки (например, C:/Python312) и завершить установку.

Шаг 5: проверить установку в командной строке:

python --version

Python без установки (python без установки)

Ожидаемый вывод:
Python 3.x.x

Python ошибка установки (ошибка установки python)

Что делать, если установщик Python выдаёт ошибку с кодом 0x80070643?

Данная ошибка часто связана с отсутствием обновлений Windows или блокировкой антивируса. Решение: временно отключить антивирус, установить все обновления системы через Центр обновления Windows и запустить установку снова. В крайнем случае помогает установка в безопасном режиме.

Как исправить ошибку 'The installer has encountered an unexpected error installing the package'?

Ошибка обычно связана с повреждённым загруженным файлом. Следует загрузить установщик заново, используя другой браузер или зеркало. Также может помогать очистка временных файлов: %temp% удалить содержимое папки temp перед установкой.

Как исправить ошибку 'api-ms-win-crt-runtime-l1-1-0.dll is missing'?

Отсутствие библиотек Visual C++. Решение: установить Microsoft Visual C++ Redistributable для Visual Studio 2015-2022 (скачать с официального сайта). После установки перезагрузить компьютер.

Как установить Python с помощью winget (Windows Package Manager)?

В Windows 10/11 winget доступен по умолчанию. Установка выполняется командой:

winget install Python.Python.3.12

установка python (установка python)

После установки следует проверить версию:
python --version

установка пакетов python (установка пакетов python)

Проблемы: winget может не найти пакет, если не обновлён список репозиториев. Решение: выполнить winget upgrade для обновления, затем повторить установку.

Что делать, если winget выдаёт ошибку 'The package manifest is invalid'?

Ошибка возникает при использовании устаревшей версии winget. Обновить менеджер через Microsoft Store или загрузить последнюю версию с GitHub.

Как решить проблему с отсутствием команды python3 на Ubuntu?

При установке Python на Ubuntu через пакетный менеджер apt команда python может отсутствовать, так как в системе может быть только python3. Установка:

sudo apt update
sudo apt install python3 python3-pip
После этого для запуска интерпретатора используется python3, а для pip - pip3. Если нужна команда python, можно создать символьную ссылку:
sudo ln -s /usr/bin/python3 /usr/bin/python

Ошибка: 'python' not found после создания ссылки. Причина: неправильный путь к python3. Проверяется командой which python3.

Как использовать pyenv для установки нескольких версий Python?

pyenv позволяет устанавливать любую версию Python, не затрагивая системную. Процесс для Ubuntu:

sudo apt update; sudo apt install -y make build-essential libssl-dev zlib1g-dev libbz2-dev libreadline-dev libsqlite3-dev wget curl llvm libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev libffi-dev liblzma-dev
git clone https://github.com/pyenv/pyenv.git ~/.pyenv
echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc
pyenv install 3.11.4
pyenv global 3.11.4
После этого python будет указывать на установленную версию. Ошибки: не хватает зависимостей для сборки (входят в список выше). Если возникает ошибка BUILD FAILED, следует установить недостающие пакеты.

Ошибка: ERROR: The Python ssl extension was not compiled. Missing the OpenSSL lib? Решение: установить libssl-dev и перезапустить сборку: pyenv uninstall 3.11.4; sudo apt install libssl-dev; pyenv install 3.11.4

Как исправить ошибку 'pip is not recognized' или 'pip: command not found'?

Если pip отсутствует, его можно установить отдельно через get-pip.py или добавить в PATH. На Windows при установке Python pip добавляется автоматически, если была выбрана соответствующая опция. Если pip не найден, следует переустановить Python с опцией "Install pip". На Linux: sudo apt install python3-pip. После установки pip может не работать из-за отсутствия модуля ensurepip. Решение: загрузить get-pip.py: curl https://bootstrap.pypa.io/get-pip.py -o get-pip.py и запустить python get-pip.py.

Ошибка: Fatal error in launcher: Unable to create process using '"c:\python312\python.exe" "C:\python312\Scripts\pip.exe" ...'. Причина: повреждённая установка или перенос Python. Решение: переустановить Python или восстановить pip командой python -m pip install --upgrade pip.

Как установить Python через conda (Miniconda), если официальный установщик не подходит?

Miniconda предоставляет минимальную среду conda с Python. Загружается с официального сайта, устанавливается. После установки создаётся окружение с нужной версией: conda create -n myenv python=3.10. Проблемы: conda требует много места, может конфликтовать с системным Python. Рекомендуется не добавлять conda в PATH, а активировать окружение через Anaconda Prompt.

Ошибка: 'conda' is not recognized. Решение: добавить папку Scripts Miniconda в PATH или запускать из Anaconda Prompt.

Как устранить ошибку 'The code execution cannot proceed because MSVCR140.dll was not found'?

Ошибка связана с отсутствием Microsoft Visual C++ Redistributable для Visual Studio 2015-2022. Скачать с официального сайта Microsoft и установить. После перезагрузки Python должен работать.

Что делать, если на macOS не запускается установщик Python (ошибка 'The installation failed')?

На macOS рекомендуется установка через Homebrew: brew install python@3.11. Если официальный установщик выдаёт ошибку, проверить целостность загруженного .pkg файла, отключить Gatekeeper временно. Также может помочь установка через pyenv на macOS: brew install pyenv; pyenv install 3.11.4.

Ошибка: 'brew: command not found'. Решение: установить Homebrew по инструкции с brew.sh.

Расширенные примеры установки и отладки

Пример 1: Установка Python из исходного кода на Ubuntu 22.04

Пример
sudo apt update
sudo apt install -y wget build-essential libssl-dev zlib1g-dev libncurses5-dev libncursesw5-dev libreadline-dev libsqlite3-dev libgdbm-dev libdb5.3-dev libbz2-dev libexpat1-dev liblzma-dev tk-dev libffi-dev
wget https://www.python.org/ftp/python/3.11.4/Python-3.11.4.tgz
tar -xf Python-3.11.4.tgz
cd Python-3.11.4
./configure --enable-optimizations --prefix=/opt/python3.11
make -j$(nproc)
sudo make altinstall

Результат: версия 3.11.4 установлена в /opt/python3.11. Для использования команда /opt/python3.11/bin/python3.11. Проблема: если не установлен libffi-dev, возникнет ошибка сборки модуля ctypes.

Пример 2: Создание виртуального окружения и устранение ошибки 'externally-managed-environment'

На новых версиях Ubuntu (23.04+) при попытке установки пакета через pip вне виртуального окружения появляется сообщение об ошибке. Решение:

Пример
python3 -m venv venv
source venv/bin/activate
pip install requests

Если требуется временно игнорировать внешнее управление:

Пример
pip install --break-system-packages requests

Пример 3: Восстановление PATH после неудачной установки Python на Windows

Иногда переменная PATH повреждается, и ни python, ни pip не работают. Восстановление через системные настройки: Настройки -> Система -> О системе -> Дополнительные параметры системы -> Переменные среды и вручную добавить пути к установленному Python (например, C:/Python312 и C:/Python312/Scripts).

Пример
# Проверить текущий PATH в PowerShell
[Environment]::GetEnvironmentVariable('Path', 'Machine') -split ';'

Пример 4: Установка pip без доступа к интернету (офлайн)

Если у компьютера нет интернета, можно заранее загрузить дистрибутив pip с другого устройства:

Пример
python -m pip download --only-binary=:all: --dest ./packages_pip pip setuptools wheel

Затем на целевой машине:

Пример
python -m pip install --no-index --find-links ./packages_pip pip setuptools wheel

Пример 5: Установка Python с помощью choco (Chocolatey) на Windows

Пример
choco install python --version=3.12.0 -y

Плюс: автоматическая настройка PATH. Минус: версия может отставать от официальной.

Результат:

Python 3.12.0 установлен. Команда python работает.

Пример 6: Ошибка 'The environment is out of date' при обновлении pip

При запуске pip install может появиться предупреждение о необходимости обновить pip. Решение:

Пример
python -m pip install --upgrade pip

Если обновление не помогает, используется принудительная переустановка:

Пример
python -m pip install --force-reinstall pip

Ошибка установки Python - comments

En
Python ошибка установки (python)