Ir al contenido

Konfigurace Pythonu a .venv ve VS Code

Řešení problémů s interpretací a virtuálními prostředími při použití VS Code v systému Windows.

0čtení

Tato příručka poskytuje definitivní technický postup pro diagnostiku, konfiguraci a implementaci vývojových prostředí Python ve Visual Studio Code v systému Windows. Pokrývá vše od správného přiřazení globálních interpretů (včetně nestandardních cest winget nebo Microsoft Store) až po automatizaci a instalaci závislostí v izolovaných prostředích (.venv).


Pro zajištění předvídatelného vývojového prostředí je zásadní oddělit uživatelské rozhraní od spouštěcího engine a balíčků závislostí každého projektu.

  • Visual Studio Code (UI/ Editor): Funguje přísně jako pokročilý textový editor a integované vývojové prostředí. Nezahrnuje integrovaný motor Pythonu; místo toho deleguje spuštění kódu externímu interpretrátoru.
  • Python Engine (python.exe): Je to binární soubor odpovědný za zpracování a interpretaci instrukcí kódu. Spouští se přímo na systému nebo uvnitř podprostředí.

Globální prostředí vs. virtuální prostředí (.venv)

Sección titulada «Entorno Global vs. Entorno Virtual (.venv)»
  • Python Global: Odpovídá základní instalaci systému. Slouží jako počáteční šablona a neměla by být upravována externími balíčky, aby se předešlo konfliktům závislostí mezi různými projekty.
  • Virtuální prostředí (.venv): Jsou to izolované podadresáře, které obsahují vlastní binární soubor Pythonu a svůj strom závislostí (site-packages).
┌──────────────────────────────────────────────────────────┐
│                   Sistema Operativo                      │
│   (Python Global - Instalación base libre de paquetes)   │
└────────────────────────────┬─────────────────────────────┘
                             │
              ┌──────────────┴──────────────┐
              ▼                             ▼
   ┌────────────────────┐        ┌────────────────────┐
   │    Proyecto A      │        │    Proyecto B      │
   │  (.venv A - Aislado)│        │  (.venv B - Aislado)│
   │  - Pandas v1.0     │        │  - Pandas v2.0     │
   │  - Requests        │        │  - Gemini API      │
   └────────────────────┘        └────────────────────┘

Přísně dodržujte následující pořadí, aby bylo zajištěno, že se vaše pracovní prostředí inicializuje a spouští Python bez chyb v závislostech.

Krok 1: Instalace oficiálního rozšíření

Sección titulada «Paso 1: Instalación de la Extensión Oficial»
  1. Přejděte na kartu Rozšíření ve VS Code (Ctrl + Shift + X).
  2. Vyhledejte oficiální rozšíření Python vyvinuté společností Microsoft.
  3. Stiskněte Instalovat. Toto rozšíření umožňuje možnosti ladění, IntelliSense a dynamickou správu interpretů v editoru.

Krok 2: Lokalizace globálního interpretu (případy winget)

Sección titulada «Paso 2: Localización del Intérprete Global (Casos de winget)»

Když se Python instaluje prostřednictvím správců balíčků, jako je winget nebo Microsoft Store, je běžné, že instalátor nezaregistruje spustitelný soubor v rámci standardních systémových cest (PATH). Chcete-li lokalizovat jeho základní spustitelný soubor:

  1. Otevřete příkazový terminál ve svém systému (CMD nebo PowerShell).
  2. Spusťte následující vyhledávací příkaz:
Ventana de terminal
where.exe python
  1. La terminal devolverá la ruta absoluta al ejecutable activo. Por ejemplo:\r C:\Program Files\Python312\python.exe o C:\Users\<Usuario>\AppData\Local\Microsoft\WindowsApps\python.exe. Conserve esta ruta.

Krok 3: Inicializace virtuálního prostředí (.venv)

Sección titulada «Paso 3: Inicialización del Entorno Virtual (.venv)»

Chcete-li se vyhnout chybám nebo blokujícím dialogovým oknům v integrovaných menu VS Code, vytvořte prostředí přímo z terminálu editoru:

  1. Otevřete integrovaný terminál ve VS Code (Ctrl + Ñ nebo Ctrl + ~).
  2. Spusťte standardní modul virtuálního prostředí pomocí názvu adresáře .venv:
Ventana de terminal
python -m venv .venv
  1. Po dokončení provedení bude v kořenu vašeho pracovního prostoru vytvořena nová složka .venv.

Krok 4: Propojení interpretu VS Code s virtuálním prostředím

Sección titulada «Paso 4: Vinculación del Intérprete de VS Code con el Entorno Virtual»

Vytvoření podsložky .venv neaktivuje připojení v editoru. Musíte vynutit, aby VS Code používal právě vytvořený interpret:

  1. Ujistěte se, že máte v editoru VS Code alespoň jeden otevřený a vybraný soubor s příponou .py (to aktivuje kontextový engine Pythonu).
  2. Otevřete Paletu příkazů pomocí Ctrl + Shift + P.
  3. Napište a vyberte Python: Select Interpreter (Python: Vybrat interpret).
  4. Editor zobrazí seznam. Vyberte možnost, která ukazuje přímo na vaše lokální prostředí. Obvykle je označena jako doporučená:
Ventana de terminal
Python 3.x.x ('.venv': venv) ./.venv/Scripts/python.exe
  1. Ověření stavu: Podívejte se na spodní pravou část stavového řádku VS Code.
    • ✕ Nesprávná cesta: Zobrazuje Python 3.x.x (používá globální systémový binární soubor).
    • ✓ Správná cesta: Zobrazuje Python 3.x.x ('.venv') (prostředí je správně propojeno).

Jakmile je v editoru propojen interpret, každý nově otevřený terminál automaticky zdědí aktivní virtuální prostředí.

  1. Otevřete nový integrovaný terminál (Ctrl + Ñ).
  2. Ověřte, zda příkazový řádek zobrazuje aktivaceční prefix na levém okraji:
Ventana de terminal
(.venv) PS C:\MiProyecto>
  1. Nainstalujte potřebné knihovny projektu přímo do svého izolovaného prostředí:
Ventana de terminal
pip install google-generativeai requests pandas

PříznakKořenová příčinaŘešení
Integrované menu Create Environment vyžaduje manuální zadání cesty a zamrzá.VS Code automaticky nenalezne základní instalaci Pythonu v PATH systému (běžné u instalací přes winget).Zrušte integrované dialogové okno. Postupujte podle Kroku 3 tohoto průvodce pro manuální vytvoření prostředí pomocí terminálu s python -m venv .venv.
Chyba ModuleNotFoundError: No module named '<libreria>' při stisku 'Play'.Kód je spouštěn jiným interpretem, než který obsahuje nainstalované balíčky (obvykle globálním).1. Zkontrolujte pravý dolní panel ve VS Code a potvrďte, že je propojen podinterpret ('.venv').
2. Pokud tomu tak není, opakujte krok 4 (Select Interpreter).
Terminál po otevření nezobrazuje prefix (.venv).Aktuální konzole se po konfiguraci interpretu neaktualizovala nebo má v PowerShellu omezenou politiku spouštění.1. Zavřete všechny aktivní terminály pomocí ikony koše v dolním panelu.
2. Otevřete zcela nový terminál (Ctrl + Ñ). Aktivní skript se spustí automaticky.
Selektor verze Python se nezobrazuje v stavové liště VS Code.Editor nenačítal kontextové služby Python, protože nejsou otevřené žádné soubory kódu.Otevřete v hlavním editoru jakýkoli soubor s příponou .py, aby se vynutila inicializace rozšíření Microsoft.