Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
Een Python-omgeving is een context waarin u Python-code uitvoert en globale, virtuele en conda-omgevingen bevat. Een omgeving bestaat uit een interpreter, een bibliotheek (meestal de Standaardbibliotheek van Python) en een set geïnstalleerde pakketten. Deze onderdelen bepalen samen geldige taalconstructies en syntaxis, besturingssysteemfunctionaliteit waartoe u toegang hebt en pakketten die u kunt gebruiken.
In Visual Studio in Windows gebruikt u het venster Python-omgevingen , zoals beschreven in dit artikel, om omgevingen te beheren en er een te selecteren als de standaardinstelling voor nieuwe projecten.
In de volgende artikelen vindt u meer informatie over andere aspecten van omgevingen:
Voor elk bepaald project kunt u een specifieke omgeving selecteren in plaats van de standaardinstelling te gebruiken.
Zie Virtuele omgevingen gebruiken voor meer informatie over het maken en gebruiken van virtuele omgevingen voor Python-projecten.
Als u pakketten in een omgeving wilt installeren, raadpleegt u de verwijzing naar het tabblad Pakketten.
Zie Python-interpreters installeren om een andere Python-interpreter te installeren. Als u in het algemeen een installatieprogramma downloadt en uitvoert voor een mainline Python-distributie, detecteert Visual Studio dat nieuwe installatie en de omgeving worden weergegeven in het venster Python-omgevingen en kunnen worden geselecteerd voor projecten.
Opmerking
U kunt omgevingen voor Python-code beheren die als map worden geopend door Bestand>Openen>Map te selecteren. Met de Python-werkbalk kunt u schakelen tussen alle gedetecteerde omgevingen en ook een nieuwe omgeving toevoegen. De omgevingsgegevens worden opgeslagen in het PythonSettings.json-bestand in de map .vs workspace.
Vereiste voorwaarden
- Een Python-workload geïnstalleerd
Als u geen kennis hebt met Python in Visual Studio, raadpleegt u de volgende artikelen voor algemene achtergrond:
Het venster Python-omgevingen
De omgevingen die Visual Studio kent, worden weergegeven in het venster Python-omgevingen . Gebruik een van de volgende methoden om het venster te openen:
- SelecteerAndere Windows>Python-omgevingen weergeven>.
- Klik met de rechtermuisknop op het knooppunt Python-omgevingen voor een project in Solution Explorer- en selecteer Alle Python-omgevingen weergeven.
Het venster Python-omgevingen wordt weergegeven naast Solution Explorer in Visual Studio:
Visual Studio zoekt naar geïnstalleerde globale omgevingen met behulp van het register (na PEP 514), samen met virtuele omgevingen en conda-omgevingen. Als u geen verwachte omgeving in de lijst ziet, raadpleegt u Handmatig een bestaande omgeving identificeren.
Wanneer u een omgeving in de lijst selecteert, worden in Visual Studio verschillende eigenschappen en opdrachten voor die omgeving weergegeven op het tabblad Overzicht van het venster Python-omgevingen , zoals de locatie van de interpreter. Met de opdrachten onder aan het tabblad Overzicht opent u een opdrachtprompt waarin de interpreter actief is. Raadpleeg de vensterverwijzing voor Python-omgevingen - Overzicht voor meer informatie.
Gebruik de vervolgkeuzelijst onder de lijst met omgevingen om over te schakelen naar verschillende tabbladen, zoals Pakketten en IntelliSense. Deze tabbladen worden ook beschreven in de naslaginformatie over het venster Python-omgevingen.
Als u een omgeving selecteert, wordt de relatie met projecten niet gewijzigd. De standaardomgeving, die vetgedrukt wordt weergegeven in de lijst, is de omgeving die in Visual Studio wordt gebruikt voor nieuwe projecten. Als u een andere omgeving met nieuwe projecten wilt gebruiken, gebruikt u de opdracht Deze standaardomgeving maken voor nieuwe projecten . Binnen de context van een project kunt u altijd een specifieke omgeving selecteren. Zie Een omgeving voor een project selecteren voor meer informatie.
Rechts van elke vermelde omgeving is een besturingselement waarmee een interactief venster voor die omgeving wordt geopend.
Opmerking
In Visual Studio 2017 15.5 en eerder verschijnt een ander besturingselement waarmee de IntelliSense-database in die omgeving wordt vernieuwd. Zie voor meer informatie over de database de tabbladreferentie voor Python-omgevingen.
Aanbeveling
Wanneer u het venster Python-omgevingen breed genoeg uitvouwt, ziet u een volledigere weergave van uw omgevingen waarmee u beter kunt werken.
Aanbeveling
Wanneer u het venster Python-omgevingen breed genoeg uitvouwt, ziet u een volledigere weergave van uw omgevingen waarmee u beter kunt werken.
Aanbeveling
Wanneer u het venster Python-omgevingen breed genoeg uitvouwt, ziet u een volledigere weergave van uw omgevingen waarmee u beter kunt werken.
Opmerking
Hoewel Visual Studio de optie voor systeem-sitepakketten respecteert, biedt het geen manier om deze te wijzigen vanuit Visual Studio.
Wat gebeurt er als er geen omgevingen worden weergegeven?
Als u geen omgevingen ziet in het venster Python-omgevingen , betekent dit dat Visual Studio geen Python-installaties op standaardlocaties kan detecteren. Misschien hebt u Visual Studio 2017 of hoger geïnstalleerd, maar alle interpreteropties in de installatieopties voor de Python-workload gewist. Op dezelfde manier hebt u Visual Studio 2015 of eerder geïnstalleerd, maar hebt u geen interpreter handmatig geïnstalleerd. Zie Python-interpreters installerenvoor meer informatie.
Als u weet dat u een Python-interpreter op uw computer hebt, maar Visual Studio (een versie) deze niet heeft gedetecteerd, gebruikt u de opdracht + Aangepast om de locatie van de interpreter handmatig op te geven. Zie Handmatig een bestaande omgeving identificeren voor meer informatie.
Typen omgevingen
Visual Studio kan werken met globale, virtuele en conda-omgevingen.
Wereldwijde omgevingen
Elke Python-installatie onderhoudt een eigen globale omgeving. Bijvoorbeeld Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0, enzovoort. Zie Python-interpreters installerenvoor meer informatie.
Elke omgeving bestaat uit de specifieke Python-interpreter, de standaardbibliotheek en een set vooraf geïnstalleerde pakketten. Het bevat ook eventuele andere pakketten die u installeert terwijl de omgeving is geactiveerd. Het installeren van een pakket in een globale omgeving maakt het beschikbaar voor alle projecten die die omgeving gebruiken. Als de omgeving zich in een beveiligd gebied van het bestandssysteem bevindt (bijvoorbeeld in c:\program-bestanden), zijn beheerdersbevoegdheden vereist voor het installeren van pakketten.
Globale omgevingen zijn beschikbaar voor alle projecten op de computer. In Visual Studio selecteert u één globale omgeving als de standaardomgeving, die wordt gebruikt voor alle projecten, tenzij u specifiek een ander voor een project kiest. Zie Een omgeving voor een project selecteren voor meer informatie.
Virtuele omgevingen
Werken in een globale omgeving is een eenvoudige manier om aan de slag te gaan. In de loop van de tijd kunnen omgevingen onoverzichtelijk worden met veel verschillende pakketten die voor verschillende projecten zijn geïnstalleerd. De rommel kan het moeilijk maken om uw toepassing grondig te testen met een specifieke set pakketten met bekende versies. Maar dit soort omgeving is wat u zou verwachten in te stellen op een buildserver of webserver. Er kunnen ook conflicten optreden wanneer twee projecten incompatibele pakketten of verschillende versies van hetzelfde pakket vereisen.
Om deze redenen maken ontwikkelaars vaak een virtuele omgeving voor een project. Een virtuele omgeving is een submap in een project dat een kopie van een specifieke interpreter bevat. Als u de virtuele omgeving activeert, worden alle pakketten die u installeert alleen geïnstalleerd in de submap van die omgeving. Wanneer u een Python-programma uitvoert in de virtuele omgeving, kunt u erop vertrouwen dat het programma alleen op die specifieke pakketten wordt uitgevoerd.
Visual Studio biedt directe ondersteuning voor het maken van een virtuele omgeving voor een project. Als u een project opent dat een requirements.txt bestand bevat, wordt u in Visual Studio gevraagd om automatisch een virtuele omgeving te maken en deze afhankelijkheden te installeren. U ziet hetzelfde gedrag wanneer u een project maakt op basis van een sjabloon die requirements.txt bestand bevat.
U kunt op elk gewenst moment binnen een geopend project een nieuwe virtuele omgeving maken. Vouw in Solution Explorer het projectknooppunt uit, klik met de rechtermuisknop op Python-omgevingen en kies Omgeving toevoegen. Kies in Omgeving toevoegende optie Virtuele omgeving. Zie Een virtuele omgeving maken voor meer informatie.
Visual Studio biedt ook een opdracht om een requirements.txt-bestand te genereren vanuit een virtuele omgeving, zodat u de omgeving eenvoudig opnieuw kunt maken op andere computers. Zie Virtuele omgevingengebruiken voor meer informatie.
Conda-omgevingen
U kunt een conda-omgeving maken met behulp van het conda hulpprogramma of met geïntegreerd conda-beheer in Visual Studio 2017 versie 15.7 en hoger. Voor een Conda-omgeving is Anaconda of Miniconda vereist. Deze platforms zijn beschikbaar via het Installatieprogramma van Visual Studio. Zie Python-ondersteuning installeren in Visual Studiovoor meer informatie.
Selecteer In het venster Python-omgevingen of op de Python-werkbalk de optie Omgeving toevoegen om het dialoogvenster Omgeving toevoegen te openen.
Selecteer in het dialoogvenster Omgeving toevoegen het tabblad Conda-omgeving :
Configureer de volgende velden:
Veld Beschrijving Project Identificeert het project waarin de omgeving moet worden gemaakt. Naam Hiermee geeft u de naam voor de conda-omgeving. Pakketten toevoegen van Hiermee geeft u op hoe u pakketten toevoegt aan de Conda-omgeving.
- Omgevingsbestand: selecteer deze optie als u een environment.yml-bestand hebt waarin uw afhankelijkheden worden beschreven. Voer de naam van het bestand in of blader (...) naar de bestandslocatie en selecteer het bestand.
- Een of meer Anaconda-pakketnamen: selecteer deze optie als u een of meer Python-pakketten of Python-versies wilt weergeven.
De pakketlijst geeft conda opdracht om een Python-omgeving te maken. Gebruik depythonopdracht om de nieuwste versie van Python te installeren. Als u een specifieke versie wilt installeren, gebruikt u de opdrachtpython=,major>.<minor>zoals inpython=3.7. U kunt de pakketknop ook gebruiken om Python-versies en algemene pakketten te selecteren in een reeks menu's.Instellen als huidige omgeving Activeert de nieuwe omgeving in het geselecteerde project nadat de omgeving is gemaakt. Instellen als standaardomgeving voor nieuwe projecten Hiermee wordt de Conda-omgeving automatisch ingesteld en geactiveerd in nieuwe projecten die zijn gemaakt in Visual Studio. Deze optie is hetzelfde als het gebruik van de standaardomgeving voor nieuwe projecten maken in het venster Python-omgevingen . Weergave in het venster van Python-omgevingen Hiermee geeft u op of het venster Python-omgevingen moet worden weergegeven nadat u de omgeving hebt gemaakt. Belangrijk
Wanneer u een Conda-omgeving maakt, moet u ten minste één Python-versie of Python-pakket opgeven om ervoor te zorgen dat de omgeving een Python-runtime bevat. U kunt een environments.yml-bestand of de pakketlijst gebruiken. Als u deze specificatie niet opgeeft, negeert Visual Studio de omgeving. De omgeving wordt nergens weergegeven in het venster Python-omgevingen , deze is niet ingesteld als de huidige omgeving voor een project en is niet beschikbaar als een globale omgeving.
Als u toevallig een Conda-omgeving zonder Python-versie maakt, gebruikt u de
conda infoopdracht om de locaties van conda-omgevingsmappen te bekijken. Vervolgens kunt u de submap voor de omgeving handmatig van die locatie verwijderen.Klik op Creëren.
U kunt het maken van de Conda-omgeving bewaken in het venster Uitvoer . Nadat het maken is voltooid, worden in de uitvoer enkele cli-instructies (opdrachtregelinterface) weergegeven, zoals conda activate env:
U kunt het maken van de Conda-omgeving bewaken in het venster Uitvoer . Nadat het maken is voltooid, worden in de uitvoer enkele cli-instructies (opdrachtregelinterface) weergegeven, zoals activate env:
In Visual Studio kunt u een Conda-omgeving voor uw project activeren op dezelfde manier als elke andere omgeving. Zie Een omgeving voor een project selecteren voor meer informatie.
Als u meer pakketten in de omgeving wilt installeren, gebruikt u het tabblad Pakketten in het venster Python-omgevingen .
Opmerking
Gebruik conda 4.4.8 of hoger voor de beste resultaten met conda-omgevingen. Houd er rekening mee dat conda-versies verschillen van Anaconda-versies. U kunt geschikte versies van Miniconda (Visual Studio 2019 en Visual Studio 2022) en Anaconda (Visual Studio 2017) installeren via het Visual Studio-installatieprogramma.
Als u de conda-versie wilt zien, waar conda-omgevingen worden opgeslagen en andere informatie, voert u de conda info opdracht uit op een Anaconda-opdrachtprompt (een opdrachtprompt waarin Anaconda zich in het pad bevindt):
conda info
Uw conda-omgevingsmappen worden als volgt weergegeven:
envs directories : C:\Users\user\.conda\envs
c:\anaconda3\envs
C:\Users\user\AppData\Local\conda\conda\envs
Omdat conda-omgevingen niet worden opgeslagen met een project, gedragen ze zich op dezelfde manier als globale omgevingen. Als u bijvoorbeeld een nieuw pakket installeert in een Conda-omgeving, wordt dat pakket beschikbaar voor alle projecten die gebruikmaken van de omgeving.
Voor Visual Studio 2017 versie 15.6 en eerder kunt u conda-omgevingen gebruiken door ze handmatig aan te wijzen, zoals beschreven in Handmatig identificeren van een bestaande omgeving.
Visual Studio 2017 versie 15.7 en hoger detecteert conda-omgevingen automatisch en geeft deze weer in het venster Python-omgevingen , zoals beschreven in de volgende sectie.
Een bestaande omgeving handmatig identificeren
Gebruik de volgende stappen om een omgeving te identificeren die is geïnstalleerd op een niet-standaardlocatie.
Selecteer In het venster Python-omgevingen of op de Python-werkbalk de optie Omgeving toevoegen om het dialoogvenster Omgeving toevoegen te openen.
Stel in het dialoogvenster Omgeving toevoegen op het tabblad Bestaande omgeving het veld <Omgeving in op Aangepast>:
Nadat u de <aangepaste> waarde hebt geselecteerd, worden er meer velden toegevoegd aan het dialoogvenster.
- Stel het Prefixpad in op het pad van de interpreter. U kunt het veld instellen door te bladeren (...) naar de padlocatie.
- Nadat u het pad hebt geselecteerd, worden de resterende velden ingevuld. Controleer de waarden en wijzig indien nodig. Wanneer u klaar bent, selecteert u Toevoegen.
U kunt ook de details van de omgeving op elk gewenst moment bekijken en wijzigen in het venster Python-omgevingen .
Selecteer in het venster Python-omgevingen de omgeving en selecteer vervolgens het tabblad Configureren .
Nadat u wijzigingen hebt aangebracht, selecteert u de opdracht Toepassen .
U kunt de omgeving ook verwijderen met behulp van de opdracht Verwijderen . Zie het tabblad Configureren voor meer informatie. Deze opdracht is niet beschikbaar voor automatisch gedetecteerde omgevingen.
Ongeldige omgevingen herstellen of verwijderen
Als Visual Studio registervermeldingen voor een omgeving vindt, maar het pad naar de interpreter ongeldig is, wordt in het venster Python-omgevingen de naam van de omgeving weergegeven in een doorhalende lettertype-indeling, zoals wordt weergegeven in de volgende afbeelding:
Als u een omgeving wilt corrigeren die u wilt behouden, probeert u eerst het herstelproces van het installatieprogramma van de omgeving te gebruiken. De meeste installatieprogramma's bevatten een reparatieoptie.
Het register wijzigen om een omgeving te corrigeren
Als de Python-omgeving geen hersteloptie heeft of als u een ongeldige omgeving wilt verwijderen, kunt u de volgende stappen uitvoeren om het register rechtstreeks te wijzigen. Visual Studio werkt het venster Python-omgevingen automatisch bij wanneer u wijzigingen aanbrengt in het register.
Voer de regedit.exe uit om de register-editor te openen.
Blader naar de omgevingsmap die overeenkomt met uw configuratie:
Python-versie Map 64-bits versie HKEY_LOCAL_MACHINE\SOFTWARE\Python of HKEY_CURRENT_USER\Software\Python 32-bits versie HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python IronPython IronPython Vouw de structuur van het distributie- en versieknooppunt voor uw omgeving uit:
Distributie Knooppunt CPython PythonCore><versienode> Anaconda ContinuumAnalytics><Versieknooppunt> IronPython <Versieknooppunt> Controleer de waarden onder het InstallPath-knooppunt :
- Als de omgeving nog steeds op uw computer bestaat, wijzigt u de waarde van de UitvoerbarePath-vermelding op de juiste locatie. Corrigeer indien nodig ook de waarden voor de (Default) en WindowedExecutablePath-vermeldingen.
- Als de omgeving niet meer op uw computer bestaat en u deze wilt verwijderen uit het venster Python-omgevingen , verwijdert u het bovenliggende versienummerknooppunt van het InstallPath-knooppunt . In de voorgaande afbeelding ziet u een voorbeeld van dit knooppunt. In het voorbeeld is dit knooppunt 3.6.
Waarschuwing
Ongeldige instellingen in de HKEY_CURRENT_USER\SOFTWARE\Python-toets overschrijven de instellingen in de HKEY_LOCAL_MACHINE\SOFTWARE\Python sleutel.
Een Python-omgeving verwijderen
Als u een Python-project wilt verwijderen, bladert u naar de Python-omgeving in Solution Explorer. Klik met de rechtermuisknop op de Python-omgeving die u wilt verwijderen en selecteer Verwijderen.
Als u de Python-omgeving wilt behouden, maar deze uit uw project wilt verwijderen, selecteert u Verwijderen. Als u de omgeving permanent wilt verwijderen, selecteert u Verwijderen.
