← Back to Module 0: Languages & Platforms

Visual Studio Code (VS Code) is a free, powerful code editor that has become the most popular IDE in the world. It works with virtually any programming language and is my recommended editor for Python development.

Why VS Code?

If you're going to learn Python (Yay!), I recommend using VS Code for several reasons:

• Free and open-source — No cost, no licensing hassles
• Works with everything — Python, R, Stata syntax, Markdown, LaTeX, and more
• Excellent Python support — With the Python extension, it rivals dedicated Python IDEs
• Git integration — Version control built right in
• AI coding assistants — GitHub Copilot and Claude Code integrate seamlessly
• Huge extension ecosystem — Add functionality for any use case

Installing VS Code

1. Download from code.visualstudio.com
2. Run the installer (works on Windows, Mac, and Linux)
3. Launch VS Code

The VS Code Interface

VS Code has a clean, customizable interface. The image below shows the main areas of the VS Code window. Hover over each numbered region to learn what it does:

1

2

3

4

Hover over a numbered region to learn about that part of VS Code.

Image source: VS Code Documentation

Note: If you are not seeing the terminal window, you can open it by going to the top menu and selecting View > Terminal or by pressing Ctrl + `.

Installing Extensions

VS Code's power comes from extensions. Here's how to install them:

1. Click the Extensions icon in the Activity Bar (or press Ctrl+Shift+X)
2. Search for the extension name
3. Click Install

Essential Extensions for This Course

Note: all names contain links to the extension pages with more details and descriptions.

Extensions for Other Languages

AI Coding Assistants

AI assistants can dramatically speed up your coding by suggesting completions, explaining code, and helping debug errors. Here are the main options:

Productivity & easy time interpreting code

Python Virtual Environments

Virtual environments are one of the most important concepts in Python development. If you skip this section, you will run into problems eventually. Trust me on this one.

What is a Virtual Environment?

Imagine your computer is an apartment building. Python is the building itself, and packages (like pandas, numpy, matplotlib) are furniture. Now imagine every project you work on is a different apartment in that building.

In technical terms, a virtual environment is an isolated Python installation with its own set of packages. When you activate a virtual environment, any packages you install go into that environment only, not your system-wide Python.

Why Do You Need Virtual Environments?

Here are the real-world problems that virtual environments solve:

Creating a Virtual Environment

Python has a built-in tool called venv for creating virtual environments. Here's how to use it:

Step 1: Open Terminal in VS Code

Press Ctrl + ` (backtick) to open the integrated terminal.

Step 2: Navigate to Your Project Folder

# Example: navigate to your project
cd ~/Documents/protools_er1/my_project

Step 3: Create the Virtual Environment

# Create a virtual environment named 'venv'
python -m venv venv

# Or with a more descriptive name
python -m venv my_project_env

# Create a virtual environment named 'venv'
python3 -m venv venv

# Or with a more descriptive name
python3 -m venv my_project_env

PS C:\Users\yourname\my_project> python -m venv venv
# (No output - command runs silently)

PS C:\Users\yourname\my_project> dir venv

    Directory: C:\Users\yourname\my_project\venv

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d-----         1/27/2026   2:45 PM                Include
d-----         1/27/2026   2:45 PM                Lib
d-----         1/27/2026   2:45 PM                Scripts
-a----         1/27/2026   2:45 PM            119 pyvenv.cfg

# Virtual environment created successfully!
# The 'venv' folder now contains your isolated Python installation.

This creates a new folder (called venv or whatever name you chose) containing a complete Python installation.

Step 4: Activate the Virtual Environment

# Activate the environment
.\venv\Scripts\Activate.ps1

# If you get an execution policy error, run this first:
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# Activate the environment
venv\Scripts\activate.bat

# Activate the environment
source venv/bin/activate

PS C:\Users\yourname\my_project> .\venv\Scripts\Activate.ps1

(venv) PS C:\Users\yourname\my_project> _

# Notice the (venv) prefix - this confirms you're in the virtual environment!
# All packages you install now will go into this environment only.

(venv) PS C:\Users\yourname\my_project> python --version
Python 3.11.5

(venv) PS C:\Users\yourname\my_project> which python
C:\Users\yourname\my_project\venv\Scripts\python.exe

You'll know it worked when you see (venv) at the beginning of your terminal prompt:

Step 5: Install Packages

Now any packages you install will go into this virtual environment:

# Install packages (they go into the venv only)
pip install pandas numpy matplotlib statsmodels

# See what's installed in this environment
pip list

Step 6: Deactivate When Done

# Leave the virtual environment
deactivate

How to Check Which Environment You're In

There are several ways to verify your current Python environment:

# Method 1: Look at your prompt
# If you see (venv) at the start, you're in the venv

# Method 2: Check which Python is being used
which python     # Mac/Linux
where python     # Windows

# If it shows a path inside your project's venv folder, you're in the venv
# Example output: /Users/yourname/my_project/venv/bin/python

import sys
print(sys.executable)
# Shows the full path to the Python interpreter
# If it's inside your venv folder, you're in the venv

import sys
print(sys.prefix)
# Shows the base location of the Python installation

# Look at the bottom-left of VS Code
# You'll see something like: Python 3.11.5 ('venv': venv)

# Or press Ctrl+Shift+P and type "Python: Select Interpreter"
# This shows all available environments

# Terminal Check (Mac/Linux):
(venv) $ which python
/Users/yourname/my_project/venv/bin/python

# Python Check:
>>> import sys
>>> print(sys.executable)
/Users/yourname/my_project/venv/bin/python

>>> print(sys.prefix)
/Users/yourname/my_project/venv

# The path includes 'venv' - confirming you're in the virtual environment!

# VS Code Check:
# Bottom-left status bar shows: Python 3.11.5 ('venv': venv)
# Command Palette > "Python: Select Interpreter" lists all available envs

Where is the Virtual Environment Stored?

The virtual environment is simply a folder in your project directory. Here's what's inside:

Sharing Your Environment: requirements.txt

To share your project with others (or recreate it on a new computer), you save the list of installed packages:

# Save your current packages to a file
pip freeze > requirements.txt

# On a new computer, recreate the environment:
python -m venv venv
source venv/bin/activate  # or .\venv\Scripts\Activate.ps1 on Windows
pip install -r requirements.txt

The requirements.txt file looks like this:

VS Code and Virtual Environments

VS Code automatically detects virtual environments in your project. Here's how to ensure VS Code uses the right one:

1. Open your project folder in VS Code
2. Create and activate a virtual environment (as shown above)
3. Press Ctrl + Shift + P and type Python: Select Interpreter
4. Choose the interpreter that shows ('venv': venv) or your environment name

From now on, VS Code will use this environment for:

• Running Python files (F5 or Ctrl+F5)
• Running code in the terminal
• IntelliSense and autocomplete
• Jupyter notebooks

Common Virtual Environment Issues

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Further Learning

Essential Keyboard Shortcuts

Video Tutorials