Глава 2 · Давайте установим Python!Типичные проблемы и диагностика
Восемь именованных лабораторий — справочник частых проблем этой главы и способов их решить.
Собрали восемь самых частых проблем этой главы в одном месте — как справочник, к которому можно будет вернуться, когда что-то пойдёт не так. Каждая уже разбиралась по ходу главы; здесь — компактная версия для быстрой диагностики.
Симптом: Команда python не найдена в терминале.
Причина и решение: Python не установлен, либо не добавлен в PATH (Windows: галочка «Add python.exe to PATH», раздел 2.3), либо на macOS/Linux нужно использовать python3 вместо python (раздел 2.4).
Симптом: pip install отказывается работать на Linux/macOS.
Причина и решение: Это защита PEP 668 (раздел 2.5): создайте и активируйте виртуальное окружение (раздел 2.11) и ставьте пакеты туда — не в системный Python.
Симптом: Пакет установлен, но import падает.
Причина и решение: Пакет установлен не в то окружение, из которого запускается код. Сверьте sys.executable (раздел 2.6) с активным окружением терминала и с интерпретатором, выбранным в VS Code (раздел 2.8) — см. лабораторию раздела 2.12.
Симптом: Поведение при запуске из VS Code отличается от запуска из терминала.
Причина и решение: Проверьте «Select Interpreter» (раздел 2.8) — выбран не тот путь. Сверьтесь с .vscode/settings.json проекта.
Симптом: Приглашение терминала не показывает (.venv), пакеты «пропали».
Причина и решение: Окружение не активировано в этом окне терминала — активация не сохраняется между вкладками (раздел 2.11). Выполните команду активации для вашей ОС заново.
Симптом: python --version показывает не ту версию, что вы только что установили.
Причина и решение: На компьютере несколько интерпретаторов, и PATH находит не тот, что ожидалось (раздел 2.2). Проверьте порядок через which / where.exe (раздел 2.6).
Симптом: В .ipynb импорт не находит пакет, который точно установлен.
Причина и решение: У блокнота выбрано другое ядро (kernel) — не то окружение, куда вы ставили пакет (раздел 2.15). Смените ядро в правом верхнем углу блокнота.
Симптом: Внутри активированного окружения команда pip всё равно не находится.
Причина и решение: Редкий случай повреждённого окружения — пересоздайте его: удалите папку .venv и выполните python -m venv .venv заново (раздел 2.11).
sys.executable (раздел 2.6), приглашение терминала (.venv) и выбор интерпретатора в редакторе (раздел 2.8) — прежде чем подозревать что-то более сложное.