Ir al contenido

Konfigurácia Python a .venv v VS Code

Riešenie problémov interpretácie a virtuálnych prostredí pomocou VS Code pod systémami Windows.

0lecturas

Táto príručka poskytuje definitívny technický postup na diagnostiku, konfiguráciu a implementáciu vývojových prostredí Pythonu v aplikácii Visual Studio Code pod systémami Windows. Pokrýva všetko od správneho priradenia globálnych interpretov (vrátane neštandardných ciest winget alebo Microsoft Store) až po automatizáciu a inštaláciu závislostí v izolovaných prostrediach (.venv).


Aby sme zabezpečili predvídateľné vývojové prostredie, je nevyhnutné oddeliť používateľské rozhranie od motora spustenia a balíčkov závislostí každého projektu.

  • Visual Studio Code (UI/Editor): Funguje striktne ako pokročilý textový editor a integrované vývojové prostredie. Nezahrňuje integrovaný motor Pythonu; namiesto toho deleguje vykonávanie kódu externému interpretovi.
  • Motor Pythonu (python.exe): Je to binárny súbor zodpovedný za spracovanie a interpretáciu inštrukcií kódu. Spúšťa sa priamo na systéme alebo v podprostrediach.

Globálne prostredie vs. Virtuálne prostredie (.venv)

Sección titulada «Entorno Global vs. Entorno Virtual (.venv)»
  • Globálny Python: Zodpovedá základnej inštalácii systému. Funguje ako počiatočná šablóna a nemal by byť modifikovaný externými balíčkami, aby sa predišlo kolíziám závislostí medzi rôznymi projektmi.
  • Virtuálne prostredia (.venv): Sú izolované podadresáre, ktoré obsahujú svoj vlastný binárny súbor Pythonu a 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      │
   └────────────────────┘        └────────────────────┘

Prísne dodržujte nasledujúci postup, aby ste zabezpečili, že vaše pracovné prostredie inicializuje a vykonáva Python bez chýb závislostí.

Krok 1: Inštalácia oficiálneho rozšírenia

Sección titulada «Paso 1: Instalación de la Extensión Oficial»
  1. Získajte prístup na kartu Rozšírenia v aplikácii VS Code (Ctrl + Shift + X).
  2. Vyhľadajte oficiálne rozšírenie Python vyvinuté spoločnosťou Microsoft.
  3. Stlačte Inštalovať. Toto rozšírenie umožňuje schopnosti ladenia, IntelliSense a dynamického správy interpretov v editore.

Krok 2: Lokalizácia globálneho interpreta (prípady winget)

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

Keď sa Python inštaluje pomocou správcov balíčkov, ako je winget alebo Microsoft Store, je obvyklé, že inštalátor nezaregistruje spustiteľný súbor do štandardných systémových ciest (PATH). Ak chcete nájsť jeho základný spustiteľný súbor:

  1. Otvorte terminál príkazov v systéme (CMD alebo PowerShell).
  2. Spustite nasledujúci vyhľadávací príkaz:
Ventana de terminal
where.exe python
  1. Terminál vráti absolútnu cestu k aktívnemu spustiteľnému súboru. Napríklad: C:\Program Files\Python312\python.exe alebo C:\Users\<Usuario>\AppData\Local\Microsoft\WindowsApps\python.exe. Uchovajte túto cestu.

Krok 3: Inicializácia virtuálneho prostredia (.venv)

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

Aby ste predišli zlyhaniu alebo blokovaniu dialógových okien v integrovaných ponukách VS Code, vykonajte vytvorenie prostredia priamo z terminálu editora:

  1. Otvorte integrovaný terminál v VS Code (Ctrl + Ñ alebo Ctrl + ~).
  2. Spustite štandardný modul virtuálneho prostredia prostredia nasmerovaný k názvu adresára .venv:
Ventana de terminal
python -m venv .venv
  1. Po dokončení vykonania sa vytvorí nový adresár .venv v koreňovom adresári vášho pracovného priestoru.

Krok 4: Prepojenie interpreta VS Code s virtuálnym prostredím

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

Vytvorenie podadresára .venv neaktivuje spojenie v editore. Musíte prinútiť VS Code používať novo vytvorený interpret:

  1. Uistite sa, že máte aspoň jeden súbor s príponou .py otvorený a vybraný v editore VS Code (toto aktivuje kontextový motor Pythonu).
  2. Otvorte paletu príkazov pomocou Ctrl + Shift + P.
  3. Zadajte a vyberte Python: Select Interpreter (Python: Vybrať interpret).
  4. Editor zobrazí zoznam. Vyberte možnosť, ktorá priamo poukazuje na vaše lokálne prostredie. Zvyčajne je označená ako odporúčaná:
Ventana de terminal
Python 3.x.x ('.venv': venv) ./.venv/Scripts/python.exe
  1. Verificación de Estado: Observe la esquina inferior derecha de la barra de estado de VS Code.
    • ✕ Nesprávna cesta: Zobrazuje Python 3.x.x (používate globálny binárny súbor systému).
    • ✓ Správna cesta: Zobrazuje Python 3.x.x ('.venv') (prostredie je správne prepojené).

Keď je interpret prepojený v editore, každá nová otvorená terminál bude automaticky dediť aktívne virtuálne prostredie.

  1. Otvorte nový integrovaný terminál (Ctrl + Ñ).
  2. Overte, že výzva príkazov zobrazuje aktivačný prefix na ľavom okraji:
Ventana de terminal
(.venv) PS C:\MiProyecto>
  1. Inštalujte potrebné knižnice projektu priamo vo vašom izolovanom prostredí:
Ventana de terminal
pip install google-generativeai requests pandas

SymptómPríčinná príčinaRiešenie
Integrované menu Create Environment vyžaduje manuálny vstup cesty a zamrzne.VS Code automaticky nenájde základnú inštaláciu Pythonu v PATH systému (časté pri inštaláciách cez winget).Zrušte integrovaný dialóg. Postupujte podľa Kroku 3 tohto návodu na vytvorenie prostredia manuálne pomocou terminálu s python -m venv .venv.
Error ModuleNotFoundError: No module named '<libreria>' al presionar ‘Play’.Kód je spustený pomocou iného interpreta, ako je ten, ktorý obsahuje nainštalované balíky (zvyčajne globálny).1. Overte dolnú pravú stranu VS Code, či máte prepojený podinterpret ('.venv').
2. Ak nie, opakujte Krok 4 (Select Interpreter).
Terminál nezobrazuje prefix (.venv) pri otvorení.Aktuálna konzola nebola aktualizovaná po konfigurácii interpreta alebo má obmedzené politiky spustenia v PowerShell.1. Zatvorte všetky aktívne terminály s ikonou koša v dolnom paneli.
2. Otvorte úplne nový terminál (Ctrl + Ñ). Skript aktivácie sa spustí automaticky.
Nezobrazuje sa výber verzie Pythonu v stavovom riadku VS Code.Editor nenahral kontextové služby Pythonu, pretože nie sú otvorené žiadne kódové súbory.Otvorte ľubovoľný súbor s príponou .py v hlavnom editore, aby ste vynútili inicializáciu rozšírenia Microsoftu.