Create Virtual Environment

Isolate your Django project dependencies

📦 What is a Virtual Environment?

A virtual environment is an isolated Python workspace that keeps project dependencies separate. This prevents conflicts between different projects and ensures your Django installation doesn't interfere with system Python packages. 


# Create a virtual environment
python -m venv myenv

# Activate it
myenv\Scripts\activate  # Windows

Output:

(myenv) C:\Users\YourName\myproject>

Why Use Virtual Environments?

🔒

Isolation

Keep project dependencies separate 

project1/ (Django 4.2)
project2/ (Django 5.0)
🛡️

No Conflicts

Avoid package version conflicts 

# Each project has its own packages
pip list
🧹

Clean System

Don't pollute global Python installation 

# System Python stays clean
python -m venv venv
📋

Reproducible

Easy to share project requirements 

pip freeze > requirements.txt

🔹 Creating a Virtual Environment

Python includes the venv module for creating virtual environments. Navigate to your project directory and create an isolated environment where Django and other packages will be installed separately from your system Python. 

# Step 1: Create project directory
mkdir mydjango
cd mydjango

# Step 2: Create virtual environment
python -m venv venv

# Alternative name
python -m venv myenv

# Check if created
dir  # Windows
ls   # Mac/Linux

Directory Structure:

mydjango/

└── venv/

├── Scripts/ (Windows)

├── Lib/

└── Include/

🔹 Activating Virtual Environment

After creating the virtual environment, you must activate it to use the isolated Python installation. The activation command differs between operating systems, and you'll see the environment name in your terminal prompt when active.

🔸 Windows 

# Command Prompt
venv\Scripts\activate.bat

# PowerShell
venv\Scripts\Activate.ps1

# If PowerShell gives error, run first:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

🔸 Mac/Linux 

# Bash/Zsh
source venv/bin/activate

# Fish shell
source venv/bin/activate.fish

After Activation:

(venv) C:\Users\YourName\mydjango>

✅ Virtual environment is now active!

🔹 Verifying Virtual Environment

Confirm your virtual environment is active and working correctly: 

# Check Python location (should point to venv)
where python  # Windows
which python  # Mac/Linux

# Check pip location
where pip     # Windows
which pip     # Mac/Linux

# List installed packages (should be minimal)
pip list

Output:

C:\Users\YourName\mydjango\venv\Scripts\python.exe

Package Version

---------- -------

pip 23.0.1

setuptools 65.5.0

🔹 Deactivating Virtual Environment

When you're done working, deactivate the virtual environment to return to your system Python: 

# Deactivate (works on all platforms)
deactivate

After Deactivation:

C:\Users\YourName\mydjango>

✅ Back to system Python

🔹 Common Virtual Environment Commands

Essential commands for managing your virtual environment: 

# Create virtual environment
python -m venv venv

# Activate
venv\Scripts\activate           # Windows
source venv/bin/activate        # Mac/Linux

# Install packages
pip install django
pip install requests

# Save dependencies
pip freeze > requirements.txt

# Install from requirements
pip install -r requirements.txt

# Upgrade pip
python -m pip install --upgrade pip

# Deactivate
deactivate

# Delete virtual environment (just delete folder)
rmdir /s venv  # Windows
rm -rf venv    # Mac/Linux

🔹 Best Practices

Follow these guidelines for effective virtual environment management:

✅ Do's:

  • Always use virtual environments for Django projects
  • Name it "venv" for consistency (or "env", ".venv")
  • Add to .gitignore - don't commit venv to Git
  • Create requirements.txt to share dependencies
  • Activate before working on your project

❌ Don'ts:

  • Don't install Django globally without venv
  • Don't commit venv folder to version control
  • Don't forget to activate before installing packages
  • Don't use system Python for project development

🔹 Troubleshooting

Common issues and solutions:

Problem: "python: command not found"

Solution: Use python3 instead of python on Mac/Linux

Problem: PowerShell activation error

Solution: Run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Problem: Virtual environment not activating

Solution: Check you're in the correct directory and venv folder exists

Problem: Packages installing globally

Solution: Ensure virtual environment is activated (check for (venv) in prompt)

🧠 Test Your Knowledge

What command creates a virtual environment named "venv"?