Установка файлов. whl (Wheel) в Python — это очень распространенная процедура для установки пакетов, особенно когда нет доступа к PyPI (Python Package Index), требуется установить определенную версию, или есть специфические зависимости. Файлы. whl — это бинарные дистрибутивы, которые содержат уже скомпилированный код, что делает установку более быстрой и надежной, так как не требуется компиляция из исходников.
Основной инструмент для установки. whl файлов — это pip.
Шаг 1: Скачайте файл .whl
Вам нужно получить файл. whl для пакета, который вы хотите установить. Обычно их можно найти:
- На странице выпуска (Releases) проекта на GitHub. На PyPI, но там обычно предлагают sdist (source distribution) и wheel файлы для разных версий Python и операционных систем. Убедитесь, что вы скачиваете правильный файл для вашей версии Python (например, cp39 для Python 3.9) и вашей операционной системы (например, win_amd64 для 64-битной Windows).
- Пример Имени Файла .whl: package_name-version-pyXY-none-platform. whl
- package_name: Имя пакета. version: Версия пакета. pyXY: Версия Python (например, cp39 для CPython 3.9). none: ABI (Application Binary Interface) тег, часто none для чистых Python-пакетов. platform: Платформа (например, any для кроссплатформенных, win_amd64, linux_x86_64).
Например: requests-2.28.1-py3-none-any. whl или numpy-1.26.4-cp39-cp39-win_amd64.whl.
Шаг 2: Откройте командную строку/терминал
Вам нужно будет использовать pip из командной строки.
- Windows: Откройте "Командную строку" (CMD) или PowerShell. MacOS/Linux: Откройте "Терминал".
Шаг 3: Перейдите в каталог, где находится файл .whl
Используйте команду cd (change directory), чтобы перейти в папку, куда вы скачали. whl файл.
Пример: Если вы скачали файл в папку Загрузки (Downloads):
- Windows:
Bash
Cd C:\Users\ВашеИмяПользователя\Downloads
- MacOS/Linux:
Bash
Cd ~/Downloads
# Или cd /Users/ВашеИмяПользователя/Downloads
(Замените ВашеИмяПользователя на ваше реальное имя пользователя).
Шаг 4: Установите .whl файл с помощью Pip
Используйте следующую команду, заменив название_файла. whl на фактическое имя файла, который вы скачали:
Bash
Pip install название_файла. whl
Пример:
Bash
Pip install requests-2.28.1-py3-none-any. whl
Важные нюансы:
- Виртуальные окружения: Настоятельно рекомендуется устанавливать пакеты в виртуальные окружения. Если вы работаете в виртуальном окружении, убедитесь, что оно активировано Перед выполнением команды pip install.
- Активация виртуального окружения (пример):
- Windows (CMD): .\venv\Scripts\activate (если ваше окружение называется venv) Windows (PowerShell): .\venv\Scripts\Activate. ps1 MacOS/Linux: source venv/bin/activate
Устранение зависимостей: pip попытается автоматически установить все зависимости, указанные в. whl файле. Если у вас нет подключения к интернету или зависимости также являются. whl файлами, которые нужно установить вручную, вам придется устанавливать их по порядку. Конфликты версий: Если у вас уже установлена другая версия пакета, pip может выдать сообщение о конфликте. Вы можете принудительно обновить пакет:
Bash
Pip install —upgrade название_файла. whl
Или удалить старую версию перед установкой новой:
Bash
Pip uninstall package_name
Pip install название_файла. whl
(замените package_name на имя пакета, например, requests).
- Проблемы с платформой/версией Python: Если вы пытаетесь установить. whl файл, который не соответствует вашей версии Python или архитектуре вашей операционной системы, pip выдаст ошибку, например:
· ERROR: название_файла. whl is not a supported wheel on this platform.
В этом случае вам нужно найти. whl файл, который был скомпилирован для вашей конкретной среды.
После успешной установки pip сообщит об этом, и пакет будет доступен для импорта в ваших Python-скриптах.
