Configuratie van Python en .venv in VS Code
Probleemoplossing voor interpreters en virtuele omgevingen met behulp van VS Code op Windows-systemen.
Deze gids biedt de definitieve technische procedure voor het diagnosticeren, configureren en implementeren van Python-ontwikkelomgevingen in Visual Studio Code op Windows-systemen. Het dekt alles, van de correcte toewijzing van globale interpreters (inclusief niet-standaard paden van winget of de Microsoft Store) tot de automatisering en installatie van afhankelijkheden in geïsoleerde omgevingen (.venv).
1. Basisprincipes van Architectuur
Sección titulada «1. Fundamentos de Arquitectura»Om een voorspelbare ontwikkelomgeving te garanderen, is het essentieel om de gebruikersinterface te scheiden van de uitvoeringsengine en de afhankelijkheidspakketten van elk project.
De Interpreter vs. De Editor
Sección titulada «El Intérprete vs. El Editor»- Visual Studio Code (UI/Editor): Werkt strikt als een geavanceerde tekstverwerker en geïntegreerde ontwikkelomgeving. Het bevat geen ingebouwde Python-engine; in plaats daarvan delegeert het de uitvoering van de code aan een externe interpreter.
- Python Engine (
python.exe): Dit is het binaire bestand dat verantwoordelijk is voor het verwerken en interpreteren van de code-instructies. Het wordt rechtstreeks op het systeem of binnen subomgevingen uitgevoerd.
Globale omgeving vs. Virtuele omgeving (.venv)
Sección titulada «Entorno Global vs. Entorno Virtual (.venv)»- Python Global: Dit komt overeen met de basisinstallatie van het systeem. Het fungeert als het initiële sjabloon en mag niet worden gewijzigd met externe pakketten om afhankelijkheidsconflicten tussen verschillende projecten te voorkomen.
- Virtuele omgevingen (
.venv): Dit zijn geïsoleerde subdirectories die hun eigen Python-binary en afhankelijkheidsboom (site-packages) inkapselen.
┌──────────────────────────────────────────────────────────┐
│ 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. Stapsgewijze Configuratieprocedure
Sección titulada «2. Procedimiento de Configuración Paso a Paso»Volg strikt de volgende volgorde om ervoor te zorgen dat uw werkruimte Python initialiseert en uitvoert zonder afhankelijkheidsfouten.
Stap 1: Installatie van de Officiële Extensie
Sección titulada «Paso 1: Instalación de la Extensión Oficial»- Ga naar het tabblad Extensies in VS Code (
Ctrl + Shift + X). - Zoek de officiële Python-extensie ontwikkeld door Microsoft.
- Klik op Installeren. Deze extensie maakt debugging-, IntelliSense- en dynamische interpreterbeheerfuncties in de editor mogelijk.
Stap 2: Het lokaliseren van de globale interpreter (gevallen van winget)
Sección titulada «Paso 2: Localización del Intérprete Global (Casos de winget)»Wanneer Python wordt geïnstalleerd via pakketbeheerders zoals winget of de Microsoft Store, is het gebruikelijk dat de installateur het uitvoerbare bestand niet registreert in de standaard systeempaden (PATH). Om uw basis-executable te lokaliseren:
- Open een opdrachtprompt op uw systeem (CMD of PowerShell).
- Voer de volgende zoekopdracht uit:
where.exe python- De terminal zal het absolute pad naar het actieve uitvoerbare bestand retourneren. Bijvoorbeeld:
C:\Program Files\Python312\python.exeofC:\Users\<Usuario>\AppData\Local\Microsoft\WindowsApps\python.exe. Bewaar dit pad.
Stap 3: Initialisatie van de virtuele omgeving (.venv)
Sección titulada «Paso 3: Inicialización del Entorno Virtual (.venv)»Om fouten of blokkerende dialoogvensters in de geïntegreerde menu's van VS Code te voorkomen, maakt u de omgeving rechtstreeks aan vanuit de terminal van de editor:
- Open een geïntegreerde terminal in VS Code (
Ctrl + ÑofCtrl + ~). - Voer de standaard virtual environment module uit, wijzend naar de directorynaam
.venv:
python -m venv .venv- Na voltooiing van de uitvoering wordt er een nieuwe directory
.venvaangemaakt in de root van uw werkruimte.
Stap 4: De VS Code-interpreter koppelen aan de virtuele omgeving
Sección titulada «Paso 4: Vinculación del Intérprete de VS Code con el Entorno Virtual»Het aanmaken van de submap .venv activeert de verbinding in de editor niet. U moet VS Code dwingen om de zojuist aangemaakte interpreter te gebruiken:
- Zorg ervoor dat je ten minste een bestand met de extensie
.pygeopend en geselecteerd hebt in de VS Code-editor (dit activeert de Python-contextengine). - Open het opdrachtpalet met behulp van
Ctrl + Shift + P. - Typ en selecteer
Python: Select Interpreter(Python: Selecteer Interpreter). - De editor toont een lijst. Selecteer de optie die direct naar uw lokale omgeving verwijst. Deze wordt meestal als aanbevolen gemarkeerd:
Python 3.x.x ('.venv': venv) ./.venv/Scripts/python.exe- Statuscontrole: Kijk naar de rechterbenedenhoek van de statusbalk van VS Code.
- ✕ Verkeerd pad: Toont
Python 3.x.x(gebruikt de globale systeem-binary). - ✓ Correct pad: Toont
Python 3.x.x ('.venv')(de omgeving is correct gekoppeld).
- ✕ Verkeerd pad: Toont
Stap 5: Console-activering en installatie van afhankelijkheden
Sección titulada «Paso 5: Activación de la Consola e Instalación de Dependencias»Zodra de interpreter in de editor is gekoppeld, zal elke nieuw geopende terminal automatisch de actieve virtuele omgeving erven.
- Open een nieuwe geïntegreerde terminal (
Ctrl + Ñ). - Controleer of de opdrachtprompt het activeringsvoorvoegsel uiterst links toont:
(.venv) PS C:\MiProyecto>- Installeer de benodigde projectbibliotheken direct binnen uw geïsoleerde omgeving:
pip install google-generativeai requests pandas3. Probleemoplossing (Troubleshooting)
Sección titulada «3. Resolución de Problemas (Troubleshooting)»| Symptoom | Hoofdoorzaak | Oplossing |
|---|---|---|
Het geïntegreerde menu Create Environment vraagt om handmatig een pad in te voeren en loopt vast. | VS Code vindt de basisinstallatie van Python niet automatisch in de PATH van het systeem (gebruikelijk bij installaties via winget). | Annuleer het geïntegreerde dialoogvenster. Volg Stap 3 van deze gids om de omgeving handmatig via de terminal te maken met python -m venv .venv. |
Fout ModuleNotFoundError: No module named '<libreria>' bij het drukken op 'Play'. | De code wordt uitgevoerd door een andere interpreter dan degene die de geïnstalleerde pakketten bevat (meestal de globale). | 1. Controleer de rechteronderbalk van VS Code om te bevestigen dat de sub-interpreter ('.venv') is gekoppeld. 2. Indien dit niet het geval is, herhaal dan Stap 4 ( Select Interpreter). |
De terminal toont het prefix (.venv) niet bij het openen. | De huidige console is niet bijgewerkt na het configureren van de interpreter of heeft beperkte uitvoeringsbeleidsregels in PowerShell. | 1. Sluit alle actieve terminals met het prullenbak-icoon in het onderste paneel. 2. Open een volledig nieuwe terminal ( Ctrl + Ñ). Het activatiescript wordt automatisch uitgevoerd. |
| De Python-versiekiezer verschijnt niet in de statusbalk van VS Code. | De editor heeft de contextuele Python-services niet geladen omdat er geen codebestanden geopend zijn. | Open een willekeurig bestand met de extensie .py in uw primaire editor om de initialisatie van de Microsoft-extensie te forceren. |

