VS Code: How to Install Python

To use Python in VS Code, you need to install the Python interpreter from python.org and then add the official Python extension from the VS Code marketplace. This article walks you through both steps, including how to verify the installation, select the correct interpreter, and fix common setup problems.

What You Need Before Installing

VS Code is a code editor, not a Python runtime. It does not include Python, so you must install Python separately. You also need the Python extension for VS Code, which provides IntelliSense, debugging, and running scripts directly from the editor. The extension is free and published by Microsoft, but it is not the same as the Python language itself.

Check your operating system first. Windows and macOS installers differ, and Linux often uses a package manager. You also need about 200 MB of free disk space for Python and a few hundred MB more for VS Code if you have not installed it yet.

Step 1: Install Python on Your System

Go to python.org/downloads and download the latest stable version for your OS. The website detects your system automatically, but you can choose a specific installer if needed.

Windows: Run the installer. Check the box that says “Add Python to PATH� before clicking Install Now. This is the most common mistake; without it, VS Code may not find Python.
macOS: Download the universal2 installer and run it. It installs to /Library/Frameworks/Python.framework. You may need to allow it in System Settings if macOS blocks it.
Linux (Ubuntu/Debian): Use the terminal: sudo apt update && sudo apt install python3 python3-pip. Some distributions do not include pip by default, so install it explicitly.

After installation, verify it. Open a terminal (Command Prompt on Windows, Terminal on macOS/Linux) and type python --version (on Linux, python3 --version). You should see something like Python 3.12.4. If you get an error, Python is not on your PATH.

Step 2: Install the Python Extension in VS Code

Open VS Code. Click the Extensions icon in the left sidebar (it looks like four squares) or press Ctrl+Shift+X (Windows/Linux) or Cmd+Shift+X (macOS). Search for “Python� and select the one published by Microsoft with the blue Python logo. Click Install.

The extension includes several tools: the Python language server, debugging support, and the built-in terminal. It also installs Pylance, a separate extension that provides fast type checking and auto-completion. You do not need to install Pylance separately; it comes as a dependency.

Step 3: Select the Python Interpreter

After installing the extension, open a Python file (with a .py extension) or create one. VS Code will ask you to select an interpreter. If it does not, open the Command Palette with Ctrl+Shift+P (or Cmd+Shift+P on macOS) and type “Python: Select Interpreter�.

Choose the Python installation you just installed. If you have multiple versions, pick the one you want. VS Code remembers your choice per workspace. You can see the selected interpreter at the bottom-right of the status bar.

If no interpreter appears, the extension cannot find Python. This usually means Python is not on your PATH. Reinstall Python and check the “Add to PATH� option, or manually add the path in VS Code settings.

Step 4: Create and Run Your First Script

Create a new file called hello.py and type:

print("Hello, VS Code Python!")

To run it, click the triangular Run button in the top-right corner, or right-click in the editor and choose “Run Python File in Terminal�. The output appears in the integrated terminal at the bottom.

You can also run code interactively by selecting lines and pressing Shift+Enter. This sends the selection to the Python interactive window, which is useful for testing snippets.

Common Problems and Fixes

Many installation issues come from three sources: PATH not set, multiple Python versions, or a corrupted extension cache.

“Python is not recognized as an internal or external command� (Windows): Reinstall Python and check “Add Python to PATH�. Alternatively, manually add the path: open System Properties → Environment Variables → Path → New → add C:\Users\YourName\AppData\Local\Programs\Python\Python312\ (adjust version).
VS Code shows “No interpreter selected� even after installing: Open the Command Palette and run “Python: Select Interpreter�. If the list is empty, click “Enter interpreter path� and browse to the python executable. On Windows it’s usually python.exe; on macOS/Linux it’s python3.
The extension fails to load or crashes: Disable and re-enable the Python extension, or restart VS Code. You can also delete the extension cache by uninstalling and reinstalling the extension.
Multiple Python versions cause confusion: Use a virtual environment. In VS Code, open the Command Palette and run “Python: Create Environment�. Choose “Venv� and select the base interpreter. This isolates your project’s packages.

Virtual Environments: Why and How

Virtual environments are not required for a basic install, but they are essential for real projects. They let you install packages without affecting the system Python. In VS Code, after creating a venv, the extension automatically detects it and uses it as the interpreter.

To create one manually, open the terminal in VS Code and run:

python -m venv .venv

Then activate it:

Windows: .venv\Scripts\activate
macOS/Linux: source .venv/bin/activate

After activation, install packages with pip install package-name. VS Code will show the venv interpreter in the status bar. This prevents version conflicts between projects.

Frequently Asked Questions

Do I need to install Python before VS Code?

Yes. VS Code is just an editor. Without Python installed, you cannot run or debug Python code. Install Python first, then the extension.

Why does VS Code not recognize Python?

Usually because Python is not on your PATH. On Windows, reinstall and check “Add Python to PATH�. On macOS/Linux, check if you installed via the official installer or package manager; sometimes the executable is named python3 instead of python.

Can I use Anaconda instead of the official Python?

Yes. If you have Anaconda installed, VS Code will detect its interpreter. You can select it in the interpreter list. Anaconda is popular for data science because it bundles many packages, but it is larger and not necessary for general Python development.

How do I update Python in VS Code?

You update Python itself, not VS Code. Download the new installer from python.org and run it; it will replace the old version. Then restart VS Code. The extension will automatically find the new version if the path is the same.

What is the difference between the Python extension and the Python language server?

The Python extension is the main package that adds language features. The language server (Pylance) is a component that provides IntelliSense, type checking, and code navigation. It is installed automatically with the Python extension.

Is the Python extension free?

Yes, the official Python extension is free and open-source. There are also community extensions, but the Microsoft one is the most maintained and recommended.

Alternatives and Next Steps

If VS Code does not meet your needs, other editors like PyCharm, Sublime Text, or Jupyter Notebook are viable alternatives. PyCharm is a full IDE with more built-in features but heavier; Jupyter is great for data analysis. However, VS Code is lightweight, free, and supports many languages, making it a good default.

After installing Python, consider learning how to use the debugger, which lets you set breakpoints and inspect variables. The Python extension also supports testing with pytest and unittest, and you can configure linting with tools like flake8 or pylint. The official VS Code documentation has detailed guides for each of these.

Method: the standard formula for this calculation, rounded as each result states. See how the calculators work or report an error.

More cards in this drawer

The whole Numbers and Powers drawer →