PyCharm 2018.2 Help

Configuring Virtualenv 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.

To create a virtual environment

  1. In the Settings/Preferences dialog (Ctrl+Alt+S), select Project: <project name> | Project Interpreter.
  2. In the Project Interpreter page, click icons general gearPlain svg and select Add.
  3. In the left-hand pane of the Add Python Interpreter dialog box, select Virtualenv Environment. The following actions depend on whether the virtual environment existed before.

    If New environment is selected:

    1. Specify the location of the new virtual environment in the text field, or click Virtual environment location and find location in your file system. Note that the directory where the new virtual environment should be located, must be empty!
    2. Choose the base interpreter from the drop-down list, or click Choose the base interpreter and find the base interpreter in the your file system.
    3. Select the Inherit global site-packages check-box if you want to inherit your global site-packages directory. This check-box corresponds to the --system-site-packages option of the virtualenv tool.
    4. Select the Make available to all projects check-box, if needed.

    If Existing environment is selected:

    1. Specify the required interpreter: use the drop-down list, or click Select an interpreter and find one in your file system.
    2. Select the check-box Make available to all projects, if needed.
  4. Click OK to complete the task.
Last modified: 20 July 2018

See Also