Як активувати віртуальне середовище Python — це базове питання для тих, хто працює з кількома проєктами й не хоче змішувати залежності між ними. Правильна активація дає змогу запускати потрібну версію пакетів у межах одного проєкту та уникати конфліктів після встановлення бібліотек.
Команда активації для Windows, macOS і Linux
Як активувати віртуальне середовище Python залежить від операційної системи та від того, де саме створена папка середовища. Найчастіше використовується стандартна команда з каталогу проєкту.
- Windows (Command Prompt): venv\Scripts\activate
- Windows (PowerShell): .\venv\Scripts\Activate.ps1
- macOS і Linux: source venv/bin/activate
Після активації в початку рядка термінала зазвичай з’являється назва середовища, наприклад (venv). Це найпростіший сигнал, що Python уже працює в межах цього середовища.
Як перевірити, що середовище дійсно активоване
Перевірка активації віртуального середовища Python показує, чи термінал використовує правильний інтерпретатор і пакети. Найнадійніший спосіб — подивитися шлях до Python та список встановлених залежностей.
- Запустіть python –version і переконайтеся, що версія відповідає вашому проєкту.
- Запустіть where python у Windows або which python у macOS і Linux, щоб побачити шлях до інтерпретатора.
- Перевірте пакет, який ви щойно встановили, через pip list.
Якщо шлях веде не до папки середовища, активація не спрацювала або термінал відкрито не в тому каталозі. У такому разі поверніться до папки проєкту й виконайте команду ще раз.
Що робити, якщо активація не працює
Проблеми з активацією віртуального середовища Python найчастіше пов’язані з політиками запуску, неправильним шляхом або відсутністю самого середовища. Безпечніше спочатку перевірити структуру папок, а вже потім змінювати системні налаштування.
Перевірте, чи середовище створене
Папка venv або інша названа вами директорія має містити підпапки Scripts у Windows або bin у macOS і Linux. Якщо їх немає, середовище потрібно створити заново командою python -m venv venv.
Перевірте політику PowerShell у Windows
PowerShell може блокувати запуск сценарію активації. Якщо команда Activate.ps1 не виконується, причина часто в обмеженій політиці виконання. У такому випадку допомагає запуск PowerShell від імені користувача з дозволом на локальні сценарії або використання Command Prompt замість нього.
Запускайте команду з коректного каталогу
Команда активації працює лише тоді, коли термінал відкрито в папці, де лежить середовище. Якщо ви бачите помилку на кшталт «файл не знайдено», спочатку перейдіть у кореневу папку проєкту й повторіть команду.
Що робити після активації
Після активації віртуального середовища Python варто одразу встановлювати залежності саме в нього, а не глобально в систему. Це зберігає проєкт від конфліктів між версіями бібліотек і спрощує відтворення середовища на іншому комп’ютері.
- Встановлюйте пакети через pip install назва_пакета.
- Зберігайте залежності в requirements.txt.
- Перед завершенням роботи вимикайте середовище командою deactivate.
Якщо після активації пакет не знаходиться, найімовірніше, ви працюєте не в тому середовищі або встановили його до глобального Python. У такому разі варто ще раз перевірити шлях до інтерпретатора й повторити інсталяцію вже після активації.
