Команда pip uninstall kivy удаляет только сам пакет, а вспомогательные зависимости — kivy-deps, docutils, pygments — остаются в системе и продолжают занимать место. Если Kivy ставился вместе с движком SDL2 и дополнительными библиотеками, для полной очистки потребуется несколько шагов, которые зависят от способа установки и операционной системы.
Ниже разобраны все сценарии: удаление через pip, чистка виртуального окружения, поиск остаточных папок и решение типичных ошибок вроде «Package not found». Инструкции актуальны для Windows, Linux и macOS — различия между системами указаны отдельно.
Проверка: установлен ли Kivy и каким способом
Перед удалением полезно выяснить, как именно Kivy попал в систему. От этого зависит правильная команда удаления. Откройте терминал или командную строку и выполните:
pip show kivy
Если пакет найден, команда выведет версию, путь установки (Location) и список зависимостей. Путь подскажет, куда ставился фреймворк: в системный Python, в пользовательский каталог или внутрь виртуального окружения. Если вместо информации появляется предупреждение WARNING: Package(s) not found, значит, в текущем интерпретаторе Kivy отсутствует — возможно, он установлен в другом окружении или под другой версией Python.
- 🔍 Проверьте все версии Python:
py -3.11 -m pip show kivyдля конкретной версии в Windows. - 🧪 Активируйте виртуальное окружение и повторите проверку, если проект создавался внутри venv.
- 📦 Посмотрите полный список пакетов командой
pip listи найдите всё, что содержит «kivy».
Удаление Kivy через pip
Стандартный способ — деинсталляция через менеджер пакетов. Вам нужно выполнить в терминале:
pip uninstall kivy
Утилита спросит подтверждение — введите y и нажмите Enter. Однако на этом работа не заканчивается: вместе с Kivy обычно устанавливаются вспомогательные пакеты, которые pip не удаляет автоматически. Их придётся убрать вручную, перечислив в одной команде:
pip uninstall kivy kivy-deps.sdl2 kivy-deps.glew kivy-deps.gstreamer docutils pygments pypiwin32 kivy-examples
Точный набор зависимостей зависит от версии и операционной системы: набор kivy-deps.* характерен для Windows, на Linux и macOS вместо него используются системные библиотеки. Сверьтесь с выводом pip list, чтобы не пропустить ничего лишнего — пакеты, которых нет в системе, pip просто пропустит с предупреждением.
⚠️ Внимание: не удаляйте пакеты «на всякий случай», если не уверены, что они принадлежат Kivy. Некоторые зависимости (например, pygments или docutils) могут использоваться другими вашими проектами — после удаления они перестанут запускаться.
Удаление из виртуального окружения и Conda
Если Kivy ставился внутрь виртуального окружения, сначала активируйте его, иначе pip uninstall будет искать пакет в системном Python и не найдёт. Активация выполняется запуском скрипта activate из папки окружения; после этого приглашение командной строки обычно показывает имя окружения в скобках.
Есть и более радикальный вариант: если окружение создавалось только под один проект с Kivy и больше не нужно, проще удалить папку окружения целиком. Это гарантированно убирает все пакеты, кэш и настройки разом — никаких «хвостов» не останется.
Для пользователей Anaconda команда отличается:
conda remove kivy
Conda сама отслеживает зависимости внутри своего окружения, поэтому ручная чистка обычно не требуется. Если пакет ставился из канала conda-forge, менеджер корректно удалит и связанные компоненты.
☑️ Чек-лист полного удаления Kivy
Очистка остаточных файлов и кэша
Даже после корректной деинсталляции на диске могут остаться служебные папки. Kivy хранит пользовательские настройки, логи и конфигурацию в отдельном каталоге, который pip не трогает. Типичные расположения:
- 📁 Windows: папка
.kivyв домашнем каталоге пользователя, напримерC:\Users\Имя\.kivy. - 🐧 Linux и macOS: скрытая папка
~/.kivyв домашней директории. - 🗂️ Кэш pip: очищается командой
pip cache purge, если нужно освободить место.
Папку .kivy можно удалить вручную через проводник или терминал — там нет ничего критичного, только конфигурация и логи. Если планируете позже установить Kivy заново с чистого листа, удаление этой папки как раз поможет избежать конфликтов старых настроек с новой версией.
Где Kivy хранит свои файлы
Помимо папки .kivy в домашнем каталоге, файлы пакета лежат в site-packages текущего интерпретатора Python — точный путь показывает команда pip show kivy в строке Location. После pip uninstall эта папка должна исчезнуть; если осталась, её можно удалить вручную.
Проверка результата после удаления
Финальный шаг — убедиться, что фреймворк действительно исчез. Запустите интерпретатор Python и попробуйте импортировать библиотеку:
python -c "import kivy"
Ожидаемый результат — ошибка ModuleNotFoundError: No module named 'kivy'. Она означает, что пакет удалён корректно. Если импорт проходит без ошибок, Kivy всё ещё доступен: вероятно, существует вторая копия в другом окружении или другой версии Python. Повторите проверку pip list для каждого интерпретатора в системе.
Типичные проблемы при удалении и их решение
Иногда деинсталляция не проходит гладко. Ниже — частые ситуации и способы их обойти, собранные в таблицу для наглядности.
| Проблема | Вероятная причина | Решение |
|---|---|---|
| Package not found | Kivy в другом окружении или версии Python | Активировать нужное окружение, повторить команду |
| Ошибка доступа при удалении | Недостаточно прав или пакет установлен для всех пользователей | Запустить терминал от имени администратора |
| Файлы заняты процессом | Запущено приложение на Kivy или IDE держит интерпретатор | Закрыть приложения и редакторы, повторить удаление |
| import kivy работает после удаления | Осталась копия в другом site-packages | Проверить путь через python -c "import kivy; print(kivy.__file__)" |
| pip не распознаётся | Python не добавлен в PATH | Использовать python -m pip uninstall kivy |
⚠️ Внимание: если командаpip uninstallзависает или завершается с ошибкой прав доступа, не применяйте флаг--forceвслепую. Сначала закройте все программы, использующие Python, и повторите попытку — принудительное удаление при заблокированных файлах может оставить повреждённые остатки пакета.
Отдельный случай — установка из исходников через pip install . или setup.py install. Такие пакеты тоже удаляются через pip uninstall, если ставились с метаданными, но при ручной установке через setup.py install без pip деинсталлятор может не найти все файлы. Тогда остатки придётся убирать вручную из папки site-packages, ориентируясь на имена каталогов с «kivy» в названии.
Часто задаваемые вопросы
Удалится ли Kivy, если просто удалить Python?
Да, при полном удалении интерпретатора Python вместе с папкой установки исчезнут и все пакеты из site-packages, включая Kivy. Однако папка .kivy в домашнем каталоге пользователя при этом останется — её нужно удалить отдельно.
Чем удалить Kivy, если pip не работает?
Используйте вызов через интерпретатор: python -m pip uninstall kivy. Если и это не помогает, найдите папку пакета в site-packages (путь виден в свойствах Python) и удалите вручную каталоги с именем kivy и файлы с расширением .dist-info или .egg-info, относящиеся к нему.
Нужно ли удалять kivy-deps отдельно?
Да, в Windows пакеты kivy-deps.sdl2, kivy-deps.glew и подобные не удаляются автоматически вместе с основным пакетом. Перечислите их в одной команде pip uninstall или удаляйте по одному, сверяясь с выводом pip list.
Повлияет ли удаление Kivy на мои проекты?
Проекты, которые импортируют kivy, перестанут запускаться с ошибкой ModuleNotFoundError. Сами файлы проектов (код, ресурсы) не пострадают — удаление затрагивает только библиотеку, а не ваши исходники.
Как удалить Kivy из проекта, собранного в exe или apk?
Готовые сборки (например, через PyInstaller или Buildozer) уже содержат Kivy внутри и не зависят от установленного в системе пакета. Удаление фреймворка из Python никак на них не повлияет; чтобы «убрать Kivy» из такой программы, достаточно удалить сам файл сборки.