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.
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).
1. Základy architektury
Sección titulada «1. Fundamentos de Arquitectura»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.
Interpretér vs. Editor
Sección titulada «El Intérprete vs. El Editor»- 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 │
└────────────────────┘ └────────────────────┘
2. Postup nastavení krok za krokem
Sección titulada «2. Procedimiento de Configuración Paso a Paso»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»- Přejděte na kartu Rozšíření ve VS Code (
Ctrl + Shift + X). - Vyhledejte oficiální rozšíření Python vyvinuté společností Microsoft.
- 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:
- Otevřete příkazový terminál ve svém systému (CMD nebo PowerShell).
- Spusťte následující vyhledávací příkaz:
where.exe python- La terminal devolverá la ruta absoluta al ejecutable activo. Por ejemplo:\r
C:\Program Files\Python312\python.exeoC:\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:
- Otevřete integrovaný terminál ve VS Code (
Ctrl + ÑneboCtrl + ~). - Spusťte standardní modul virtuálního prostředí pomocí názvu adresáře
.venv:
python -m venv .venv- 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:
- 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). - Otevřete Paletu příkazů pomocí
Ctrl + Shift + P. - Napište a vyberte
Python: Select Interpreter(Python: Vybrat interpret). - Editor zobrazí seznam. Vyberte možnost, která ukazuje přímo na vaše lokální prostředí. Obvykle je označena jako doporučená:
Python 3.x.x ('.venv': venv) ./.venv/Scripts/python.exe- 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).
- ✕ Nesprávná cesta: Zobrazuje
Krok 5: Aktivace konzole a instalace závislostí
Sección titulada «Paso 5: Activación de la Consola e Instalación de Dependencias»Jakmile je v editoru propojen interpret, každý nově otevřený terminál automaticky zdědí aktivní virtuální prostředí.
- Otevřete nový integrovaný terminál (
Ctrl + Ñ). - Ověřte, zda příkazový řádek zobrazuje aktivaceční prefix na levém okraji:
(.venv) PS C:\MiProyecto>- Nainstalujte potřebné knihovny projektu přímo do svého izolovaného prostředí:
pip install google-generativeai requests pandas3. Řešení problémů (Troubleshooting)
Sección titulada «3. Resolución de Problemas (Troubleshooting)»| Příznak | Koř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. |

