Как создать виртуальное окружение в pycharm

Configure a virtual environment

PyCharm makes it possible to use the virtualenv tool to create a project-specific isolated virtual environment . The main purpose of virtual environments is to manage settings and dependencies of a particular project regardless of other Python projects. virtualenv tool comes bundled with PyCharm, so the user doesn’t need to install it.

For Python 3.3+ the built-in venv module is used, instead of the third-party virtualenv utility.

Create a virtualenv environment

Do one of the following:

Click the Python Interpreter selector and choose Add New Interpreter .

Press Ctrl+Alt+S to open Settings and go to Project: <project name> | Python Interpreter . Click the Add Interpreter link next to the list of the available interpreters.

Click the Python Interpreter selector and choose Interpreter Settings . Click the Add Interpreter link next to the list of the available interpreters.

Select Add Local Interpreter .

In the left-hand pane of the Add Python Interpreter dialog, select Virtualenv Environment .

The following actions depend on whether you want to create a new virtual environment or to use an existing one.

Specify the location of the new virtual environment in the Location field, or click and browse for the desired location in your file system. The directory for the new virtual environment should be empty.

Choose the base interpreter from the list, or click and find the desired Python executable in your file system.

Select the Inherit global site-packages checkbox if you want all packages installed in the global Python on your machine to be added to the virtual environment you’re going to create. This checkbox corresponds to the —system-site-packages option of the virtualenv tool.

Choose the desired interpreter from the list.

If the desired interpreter is not on the list, click , and then browse for the desired Python executable (for example, venv/bin/python on macOS or venv\Scripts\python.exe on Windows).

The selected virtual environment will be reused for the current project.

Click OK to complete the task.

If PyCharm displays the Invalid environment warning, it means that the specified Python binary cannot be found in the file system, or the Python version is not supported. Check the Python path and install a new version, if needed.

You can create as many virtual environments as required. To easily tell them from each other, use different names.

Use an existing interpreter

Press Ctrl+Alt+S to open the IDE settings and select Project <project name> | Python Interpreter .

Expand the list of the available interpreters and click the Show All link. Alternatively, click the icon and select Show All .

Virtual environments are marked with .

Select the target environment from the list and click OK to confirm your choice.

PyCharm can create a virtual environment for your project based on the project requirements.

Create a virtual environment using the project requirements

Open any directory with your source files that contains the requirements.txt or setup.py file: select File | Open from the main menu and choose the directory.

If no virtual environment has been created for this project, PyCharm suggests creating it:

Keep the suggested options, or specify the environment location or base Python interpreter. Click OK to complete the task.

Once you click OK , PyCharm creates an environment and installs all the required packages. On the completion, see the notification popup:

Note that if you ignore a suggestion to create a virtual environment, PyCharm won’t create a Python interperter for your project. So, any time when you open a .py file, you’ll see the warning with the options for configuring a project interpreter:

This approach is particularly helpful when you want to upgrade a version of Python your environment is based on, for example, from 3.5 to 3.9. You can specify a new base interpreter and use requirements.txt to ensure all the needed packages are installed.

For any of the configured Python interpreters (but Docker-based), you can:

Once you have create a new virtual environment, you can reuse it for your other projects. Learn more how to setup an existing environment as a Python interpreter.

Введение в Virtual Environments

Если вы работали с несколькими проектами, в которых использовался Python, то наверняка вы встречались с проблемой поломки одного из проекта, потому что обновленная версия библиотеки для другого проекта, не применима для текущего. Т.е. если вы работаете с Python и не используете miniconda или anaconda, то установка и обновление библиотек python постоянно ломает ваши проекты. Эта проблема называется «Ад зависимостей».

Поэтому лучшим подходом будет создавать для каждого отдельного проекта свою среду. В этой статье будет рассмотрена библиотека venv для настройки Virtual Environment для Windows.

Виртуальная среда — это способ Python для разделения зависимостей между проектами.

Создание виртуальной среды — venv в Windows

venv -это пакет, поставляемый с Python 3.

venv (для Python 3) позволяет управлять отдельными установками пакетов для разных проектов. По сути, venv позволяет вам создавать «виртуальную» изолированную установку Python и устанавливать пакеты в эту виртуальную установку. При переключении проектов вы можете просто создать новую виртуальную среду и не беспокоиться о нарушении работы пакетов, установленных в других средах. При разработке приложений Python всегда рекомендуется использовать виртуальную среду.

Чтобы создать виртуальную среду, перейдите в каталог вашего проекта и запустите venv.

venv создаст виртуальную установку Python в директории venv .

Примечание: Вы должны исключить каталог виртуальной среды из своей системы управления версиями с помощью .gitignore .

Активация и деактивация виртуальной среды Python

Далее необходимо активировать виртуальную среду.

Для этого необходимо в консоли cmd запустить .\venv\Scripts\activate или файл .\venv\Scripts\activate.bat , или .\venv\Scripts\Activate.ps1 .

Префикс вашего рабочего каталога изменится (выделил желтым — venv)

Пока ваша виртуальная среда активирована, pip будет устанавливать пакеты в эту конкретную среду, и вы сможете импортировать и использовать пакеты в своем приложении Python.

Установка пакетов в виртуальную среду

Пример:

pip позволяет вам указать, какую версию пакета установить, используя спецификаторы версии . Например, чтобы установить определенную версию requests :

Как сохранить пакеты в файл requirements.txt

Pip может экспортировать список всех установленных пакетов и их версий с помощью freeze команды: pip freeze > requirements.txt .

Будет выведен список спецификаторов пакетов, таких как:

Имейте в виду, что в этом случае в файле requirements.txt будут перечислены все пакеты, которые были установлены в виртуальной среде, независимо от того, откуда они пришли.

Установить пакеты из файла requirements.txt

Как запустить скрипт Python в виртуальной среде. Пример автоматизации с помощью cmd

Для того, чтобы запустить скрипт, достаточно внутри директории с проектом (со средой) запустить команду:

Либо создать файл cmd с содержимым и запустить его:

Создание виртуальной среды с помощью PyCharm

Для более легкой работы с виртуальными средами на Windows рекомендую установить PyCharm (Community Edition бесплатная). При создании проекта он сам создаст виртуальную среду и будет запускать файл в этой виртуальной среде:

Новую виртуальную среду можно создать с помощью разных инструментов в Pycharm:

How to create a Virtual environment in PyCharm?

In Python, a virtual environment creates an isolated environment for each project. By doing this, every project can have its own dependencies regardless of what dependencies the other project are employing.

Why do developers need virtual environments?

Let's understand the question of “why?” with a simple example:

Imagine that you are working with 2 projects, project A and project B. Project A works with TensorFlow 1.10.0 while project B works with TensorFlow 2.3.0. In such situations, installing the versions globally may create conflicts. Therefore in such situations, maintaining dependencies of each project in isolation is very useful.

As you now know why virtual environments are required, let's get started with creating one!

Step 1: Create a new project

Create a new project and give it a name

Then, select the radio button with the label “New environment using” and select Virtualenv from the dropdown.

Step 2: Create a virtual environment

Next, give a location to the virtual environment and select the base interpreter.

Here, if you check the checkbox labelled “Inherit global site-packages”, all the globally installed libraries and packages will be inherited by this project’s virtual environment.

When you click on the “Create” button, the virtual environment will be created.

Once the virtual environment is created, you can see the venv directory under your project folder (see the image below).

Bravo! you have now created the virtual environment for your project.

Any edits, deletes or installations of new packages to this virtual environment will only be available for the particular project. It will not interfere with the other projects that you work on.

Step 03: Installing a package to the virtual environment

As the virtual environment is now set up, you can install any library into it by using the command

Example: I am installing NumPy to my virtual environment

Now, if you go to File → Settings →Project →Project Interpreter, you can see NumPy installed in my virtual environment

Now you can continue with your project and install dependencies without interfering other projects.

Создание виртуальных окружений на Python

PyCharm позволяет использовать инструмент virtualenv для создания изолированной виртуальной среды конкретного проекта. Основная цель виртуальных сред — управлять настройками и зависимостями конкретного проекта независимо от других проектов Python. Инструмент virtualenv поставляется в комплекте с PyCharm, поэтому пользователю не нужно его устанавливать.

Для Python 3.3+ используется встроенный модуль venv, а не сторонняя утилита virtualenv.

Создание виртуальной среды

1. Убедитесь, что вы загрузили и установили Python на свой компьютер.(Если у вас еще нет Python, скачать его можно с официального сайта: https://www.python.org/downloads/
2. Нажмите Ctrl+Alt+S, чтобы открыть Настройки проекта.
3. В диалоговом окне Настройки/Предпочтения Ctrl+Alt+S выберите Проект | Интерпретатор Python. Щелкните значок Настроить интерпретатор проекта и выберите Добавить.
4. В левой панели диалогового окна Добавить интерпретатор Python выберите VirtualenvEnvironment. Следующие действия зависят от того, существовала ли виртуальная среда ранее.

Если выбрана новая среда:

1. Укажите местоположение новой виртуальной среды в текстовом поле или нажмите кнопку Расположение виртуальной среды и найдите местоположение в файловой системе. Обратите внимание, что каталог, в котором должна находиться новая виртуальная среда, должен быть пустым!
2. Выберите базовый интерпретатор из списка или нажмите кнопку Выбрать базовый интерпретатор и найдите исполняемый файл Python в вашей файловой системе. Если PyCharm не обнаруживает Python на вашем компьютере, он предоставляет два варианта: загрузить последние версии Python с вашего компьютера. python.org или указать путь к исполняемому файлу Python (в случае нестандартной установки).
3. Установите флажок Inheritglobalsite-packages, если вы хотите наследовать свой каталог глобальных пакетов сайтов. Этот флажок соответствует параметру —system-site-packages инструмента virtualenv.
4. При необходимости установите флажок Make available to all projects.

Если выбрана существующая среда:

1. Разверните список переводчиков и выберите любой из существующих переводчиков. Кроме того, нажмите кнопку Выбрать интерпретатор и укажите путь к исполняемому файлу Python в вашей файловой системе, например: C:\Python36\python.exe.
2. Установите флажок Сделать доступными все проекты, если это необходимо.
3. Нажмите кнопку ОК, чтобы завершить выполнение задачи.

Вы можете создать столько виртуальных сред, сколько потребуется. Чтобы легко отличить их друг от друга, используйте разные имена.

Настройка существующей виртуальной среды

1. Откройте диалоговое окно Настройки / настройки, нажав Ctrl+Alt+S или выбрав Файл | Настройки для Windows и Linux или PyCharm | Настройки для macOS. Выберите Project | Интерпретатор Python.
2. Разверните список доступных переводчиков и нажмите на ссылку Показать все. Кроме того, щелкните значок «Настроить интерпретатор проекта» и выберите «Показать все». Виртуальные среды помечаются как Виртуальная среда.
3. Выберите целевую среду из списка и нажмите кнопку ОК, чтобы подтвердить свой выбор. PyCharm может создать виртуальную среду для вашего проекта на основе требований проекта.

Создайте виртуальную среду, используя требования проекта

1. Откройте любой каталог с исходными файлами, содержащий requirements.txt или setup.py файл: выберите Файл | Открыть в главном меню и выберите каталог.
2. Если для этого проекта не была создана виртуальная среда, PyCharm предлагает создать ее:
   Сохраните предложенные параметры или укажите местоположение среды или базовый интерпретатор Python. Нажмите кнопку ОК, чтобы завершить выполнение задачи. Как только вы нажмете кнопку ОК, PyCharm создаст среду и установит все необходимые пакеты.

По завершении смотрите всплывающее окно уведомления. Обратите внимание, что если вы проигнорируете предложение создать виртуальную среду, PyCharm не создаст Python interperter для вашего проекта. Таким образом, каждый раз, когда вы открываете файл .py, вы увидите предупреждение с параметрами настройки интерпретатора проекта.