PyCharm Invalid Python Interpreter / Invalid Environment

How to fix it

Try these in order — the most common fix is first.

1. 1. Select the correct executable

   Copy steps
   1. Press Ctrl+Alt+S and open Project Structure (or click the Python Interpreter widget in the status bar)
   2. Click the browse button (...) next to the interpreter list
   3. Pick venv/bin/python on macOS/Linux or venv\Scripts\python.exe on Windows
   Did this fix it? Yes No

2. 2. Recreate the environment

   Copy steps
   1. Click the Python Interpreter widget
   2. Choose Recreate Environment (this deletes the environment, so reinstall packages afterwards)
   Did this fix it? Yes No

3. 3. Remove the stale interpreter and add a new one

   Copy steps
   1. Ctrl+Alt+S, then Python | All Interpreters
   2. Select the interpreter and click Remove Interpreter (no confirmation)
   3. Back in Project Structure click Add Interpreter... then Add Local Interpreter...
   Did this fix it? Yes No

4. 4. Install a supported Python

   Copy steps
   1. Download a supported Python version from python.org
   2. Add it as a local interpreter
   Did this fix it? Yes No

Symptoms

A warning on .py files and the interpreter widget says the environment is invalid; code runs fail and inspections stop working.

Why it happens

• The Python executable was moved, deleted or upgraded
• The virtual environment folder was removed
• The Python version is not supported by this PyCharm version

This guide also covers

• pycharm invalid python interpreter
• pycharm python interpreter not found
• pycharm invalid environment
• pycharm no python interpreter configured

Other PyCharm errors

• PyCharm No Python Interpreter Configured for the Project
• PyCharm Unresolved Reference: Installed Package Not Recognized
• PyCharm Cannot Install or Find a Package
• PyCharm Conda Executable Not Found / Conda Environment Not Detected
• PyCharm Indexing Takes Forever / Stuck on Analyzing Project
• PyCharm Low Memory Warning: How to Increase the Heap Size
• PyCharm Invalidate Caches / Restart: When and How
• PyCharm Debugger Not Working / Breakpoints Not Hit