Python Documentation

Virtual Environments

Menu

Virtual Environments in Python

Virtual environments are isolated Python environments that allow you to install and manage packages for specific projects without affecting your system-wide Python installation.

Why Use Virtual Environments?

  • Isolate project dependencies
  • Avoid conflicts between different project requirements
  • Easily share project setups with others
  • Test projects with different Python versions

Creating a Virtual Environment

To create a virtual environment, use the following command:

python -m venv myenv

This creates a new virtual environment named "myenv" in your current directory.

Activating a Virtual Environment

To activate the virtual environment:

# On Windows
myenv\Scripts\activate

# On macOS and Linux
source myenv/bin/activate

Working with Virtual Environments

Once activated, you can install packages using pip without affecting your global Python installation:

pip install package_name

Deactivating a Virtual Environment

To exit the virtual environment, simply run:

deactivate

Best Practices

  • Create a new virtual environment for each project
  • Use descriptive names for your virtual environments
  • Include your project's requirements.txt file in version control
  • Don't commit the virtual environment folder to version control

Alternative Tools

While venv is built into Python, there are other popular tools for managing virtual environments:

  • virtualenv: A more feature-rich alternative to venv
  • conda: An environment manager that handles both Python and non-Python dependencies
  • pipenv: Combines pip and virtualenv into a single tool

Virtual environments are an essential tool for Python developers, ensuring clean, reproducible, and isolated development environments for each project.