Skapa och hantera Python-miljöer i Visual Studio

En Python-miljö är en kontext där du kör Python-kod och innehåller globala, virtuella miljöer och conda-miljöer. En miljö består av en tolk, ett bibliotek (vanligtvis Python Standard Library) och en uppsättning installerade paket. Dessa komponenter bestämmer tillsammans giltiga språkkonstruktioner och syntax, operativsystemfunktioner som du kan komma åt och paket som du kan använda.

I Visual Studio i Windows använder du fönstret Python-miljöer , enligt beskrivningen i den här artikeln, för att hantera miljöer och välja en som standard för nya projekt.

Du kan lära dig mer om andra aspekter av miljöer i följande artiklar:

• För ett visst projekt kan du välja en specifik miljö i stället för att använda standardvärdet.

• Mer information om hur du skapar och använder virtuella miljöer för Python-projekt finns i Använda virtuella miljöer.

• Om du vill installera paket i en miljö, se 'Referens för paketfliken'.

• Information om hur du installerar en annan Python-tolk finns i Installera Python-tolkar. Om du i allmänhet laddar ned och kör ett installationsprogram för en Python-distribution på huvudlinjen identifierar Visual Studio att ny installation och miljö visas i fönstret Python-miljöer och kan väljas för projekt.

Anmärkning

Du kan hantera Python-miljöer som öppnas i en mapp genom att välja Fil>Öppna>Mapp. Med Python-verktygsfältet kan du växla mellan alla identifierade miljöer och även lägga till en ny miljö. Miljöinformationen lagras i filenPythonSettings.json i arbetsytans .vs-mapp .

Förutsättningar

• En Python-arbetsbelastning installerad

Om du inte har använt Python tidigare i Visual Studio kan du läsa följande artiklar för allmän bakgrund:

• Python-stöd i Visual Studio i Windows
• Installera Python-stöd i Visual Studio

Fönstret Pythonmiljöer

De miljöer som Visual Studio känner till visas i fönstret Python-miljöer . Öppna fönstret med någon av följande metoder:

• Välj Visa>andra Windows>Python-miljöer.
• Högerklicka på noden Python-miljöer för ett projekt i Solution Explorer och välj Visa alla Python-miljöer.

Fönstret Python-miljöer visas tillsammans med Solution Explorer i Visual Studio:

Visual Studio söker efter installerade globala miljöer med hjälp av registret (enligt PEP 514), tillsammans med virtuella miljöer och conda-miljöer. Om du inte ser en förväntad miljö i listan kan du läsa Manuellt identifiera en befintlig miljö.

När du väljer en miljö i listan visar Visual Studio olika egenskaper och kommandon för den miljön på fliken Översikt i fönstret Python-miljöer , till exempel tolkplatsen. Kommandona längst ned på fliken Översikt öppnar var och en ett kommandofönster där kommandotolken körs. Mer information finns i flikreferens för Python-miljöer – Översikt.

Använd listrutan under listan över miljöer för att växla till olika flikar som Paket och IntelliSense. De här flikarna beskrivs också i flikreferensen för Python-miljöer.

Om du väljer en miljö ändras inte dess relation till några projekt. Standardmiljön, som visas i fetstil i listan, är den som Visual Studio använder för alla nya projekt. Om du vill använda en annan miljö med nya projekt använder du kommandot Gör detta till standardmiljö för nya projekt . Inom ramen för ett projekt kan du alltid välja en specifik miljö. Mer information finns i Välj en miljö för ett projekt.

Till höger om varje listad miljö är en kontroll som öppnar ett interaktivt fönster för den miljön.

Anmärkning

I Visual Studio 2017 15.5 och tidigare visas en annan kontroll som uppdaterar IntelliSense-databasen för den miljön. Mer information om databasen finns i fönsterfliksreferensen för Python-miljöer.

Tips/Råd

När du expanderar Python-miljöfönstret tillräckligt brett ser du en mer fullständig vy över dina miljöer som kan vara enklare att arbeta med.

Anmärkning

Visual Studio respekterar alternativet system-site-packages, men det ger inte något sätt att ändra det från Visual Studio.

Vad händer om inga miljöer visas?

Om du inte ser några miljöer i Python-miljöfönstret innebär det att Visual Studio inte kunde identifiera några Python-installationer på standardplatser. Du kanske installerade Visual Studio 2017 eller senare men rensade alla tolkalternativ i installationsalternativen för Python-arbetsbelastningen. På samma sätt har du eventuellt installerat Visual Studio 2015 eller tidigare men inte installerat en tolk manuellt. Mer information finns i Installera Python-tolkar.

Om du vet att du har en Python-tolk på datorn men Visual Studio (vilken version som helst) inte identifierade den använder du kommandot + Anpassad för att ange tolkplatsen manuellt. Mer information finns i Identifiera en befintlig miljö manuellt.

Miljötyper

Visual Studio kan arbeta med globala, virtuella miljöer och conda-miljöer.

Globala miljöer

Varje Python-installation underhåller sin egen globala miljö. Till exempel Python 2.7, Python 3.6, Python 3.7, Anaconda 4.4.0 och så vidare. Mer information finns i Installera Python-tolkar.

Varje miljö består av den specifika Python-tolken, dess standardbibliotek och en uppsättning förinstallerade paket. Den innehåller även andra paket som du installerar medan miljön aktiveras. Om du installerar ett paket i en global miljö blir det tillgängligt för alla projekt som använder den miljön. Om miljön finns i ett skyddat område i filsystemet (till exempel i c:\program-filer) kräver installation av paket administratörsbehörighet.

Globala miljöer är tillgängliga för alla projekt på datorn. I Visual Studio väljer du en global miljö som standard, som används för alla projekt om du inte specifikt väljer en annan för ett projekt. Mer information finns i Välj en miljö för ett projekt.

Virtuella miljöer

Att arbeta i en global miljö är ett enkelt sätt att komma igång. Med tiden kan miljöer bli belamrade med många olika paket installerade för olika projekt. Oredan kan göra det svårt att noggrant testa programmet mot en specifik uppsättning paket med kända versioner. Men den här typen av miljö är vad du kan förvänta dig att konfigurera på en byggserver eller webbserver. Konflikter kan också uppstå när två projekt kräver inkompatibla paket eller olika versioner av samma paket.

Därför skapar utvecklare ofta en virtuell miljö för ett projekt. En virtuell miljö är en undermapp i ett projekt som innehåller en kopia av en specifik tolk. Om du aktiverar den virtuella miljön installeras alla paket som du installerar endast i den miljöns undermapp. När du kör ett Python-program i den virtuella miljön kan du vara säker på att programmet endast körs mot de specifika paketen.

Visual Studio ger direkt stöd för att skapa en virtuell miljö för ett projekt. Om du öppnar ett projekt som innehåller en requirements.txt fil uppmanar Visual Studio dig att automatiskt skapa en virtuell miljö och installera dessa beroenden. Du ser samma beteende när du skapar ett projekt från en mall som innehåller requirements.txt fil.

När som helst i ett öppet projekt kan du skapa en ny virtuell miljö. I Solution Explorer expanderar du projektnoden, högerklickar på Python-miljöer och väljer Lägg till miljö. I Lägg till miljö väljer du Virtuell miljö. Mer information finns i Skapa en virtuell miljö.

Visual Studio innehåller också ett kommando för att generera en requirements.txt fil från en virtuell miljö, vilket gör det enkelt att återskapa miljön på andra datorer. Mer information finns i Använda virtuella miljöer.

Conda-miljöer

Du kan skapa en conda-miljö med hjälp conda av verktyget eller med integrerad conda-hantering i Visual Studio 2017 version 15.7 och senare. En conda-miljö kräver Anaconda eller Miniconda. Dessa plattformar är tillgängliga via Visual Studio Installer. Mer information finns i Installera Python-stöd i Visual Studio.

1. I fönstret Python-miljöer eller i Python-verktygsfältet väljer du Lägg till miljö för att öppna dialogrutan Lägg till miljö .

2. I dialogrutan Lägg till miljö väljer du fliken Conda-miljö :

   

3. Konfigurera följande fält:

   Fält	Description
   Projekt	Identifierar det projekt där miljön ska skapas.
   Namn	Anger namnet på conda-miljön.
   Lägga till paket från	Anger hur du lägger till paket i conda-miljön. - Miljöfil: Välj det här alternativet om du har en environment.yml fil som beskriver dina beroenden. Ange namnet på filen eller bläddra (...) till filplatsen och välj filen. - Ett eller flera Anaconda-paketnamn: Välj det här alternativet om du vill visa en lista över ett eller flera Python-paket eller Python-versioner. Paketlistan instruerar conda att skapa en Python-miljö. Om du vill installera den senaste versionen av Python använder du python kommandot . Om du vill installera en viss version använder du kommandot python=,major>.<minor> som i python=3.7. Du kan också använda paketknappen för att välja Python-versioner och vanliga paket från en serie menyer.
   Ange som aktuell miljö	Aktiverar den nya miljön i det valda projektet när miljön har skapats.
   Ange som standardmiljö för nya projekt	Ställer in och aktiverar conda-miljön automatiskt i alla nya projekt som skapats i Visual Studio. Det här alternativet är detsamma som att använda fönstret Gör detta till standardmiljö för nya projekt i Python-miljöfönstret .
   Visa i Python-miljöfönstret	Anger om python-miljöfönstret ska visas när miljön har skapats.

   Viktigt!

   När du skapar en conda-miljö måste du ange minst en Python-version eller Ett Python-paket för att säkerställa att miljön innehåller en Python-körning. Du kan använda en environments.yml-fil eller paketlistan. Om du inte anger den här specifikationen ignorerar Visual Studio miljön. Miljön visas inte någonstans i Python-miljöfönstret , den anges inte som aktuell miljö för ett projekt och är inte tillgänglig som en global miljö.

   Om du råkar skapa en conda-miljö utan en Python-version använder du conda info kommandot för att se platserna för conda-miljömappar. Du kan sedan manuellt ta bort undermappen för miljön från den platsen.

4. Välj Skapa.

Du kan övervaka skapandet av conda-miljön i fönstret Utdata . När skapandet är klart visar utdata vissa cli-instruktioner (kommandoradsgränssnitt), till exempel conda activate env:

1. I Visual Studio kan du aktivera en conda-miljö för projektet på samma sätt som för andra miljöer. Mer information finns i Välj en miljö för ett projekt.

2. Om du vill installera fler paket i miljön använder du fliken Paket i fönstret Python-miljöer .

Anmärkning

Använd conda 4.4.8 eller senare för bästa resultat med conda-miljöer. Tänk på att conda-versioner skiljer sig från Anaconda-versioner. Du kan installera lämpliga versioner av Miniconda (Visual Studio 2019 och Visual Studio 2022) och Anaconda (Visual Studio 2017) via Visual Studio Installer.

Kör conda info kommandot i en Anaconda-kommandotolk (en kommandotolk där Anaconda finns i sökvägen) för att se conda-versionen, var conda-miljöer lagras, och få annan relevant information.

conda info

Dina conda-miljömappar visas på följande sätt:

       envs directories : C:\Users\user\.conda\envs
                          c:\anaconda3\envs
                          C:\Users\user\AppData\Local\conda\conda\envs

Eftersom conda-miljöer inte lagras med ett projekt beter de sig på samma sätt som globala miljöer. Om du till exempel installerar ett nytt paket i en conda-miljö blir paketet tillgängligt för alla projekt som använder miljön.

För Visual Studio 2017 version 15.6 och tidigare kan du använda conda-miljöer genom att peka på dem manuellt enligt beskrivningen i Identifiera en befintlig miljö manuellt.

Visual Studio 2017 version 15.7 och senare identifierar conda-miljöer automatiskt och visar dem i Fönstret Python-miljöer enligt beskrivningen i nästa avsnitt.

Identifiera en befintlig miljö manuellt

Använd följande steg för att identifiera en miljö som är installerad på en plats som inte är standard.

1. I fönstret Python-miljöer eller i Python-verktygsfältet väljer du Lägg till miljö för att öppna dialogrutan Lägg till miljö .

2. I dialogrutan Lägg till miljö på fliken Befintlig miljö anger du fältet Miljö till <Anpassad>:

När du har valt värdet <Anpassad> läggs fler fält till i dialogrutan.

3. Ange fältet Prefixsökväg till tolkens sökväg. Du kan ange fältet genom att bläddra (...) till sökvägens plats.

4. När du har valt sökvägen fylls de återstående fälten i. Granska värdena och ändra efter behov. När du är klar väljer du Lägg till.

Du kan också granska och ändra information om miljön när som helst i fönstret Python-miljöer .

1. I fönstret Python-miljöer väljer du miljön och väljer sedan fliken Konfigurera .

2. När du har ändrat väljer du kommandot Tillämpa .

Du kan också ta bort miljön med hjälp av kommandot Ta bort . Mer information finns på fliken Konfigurera. Det här kommandot är inte tillgängligt för automatiskt identifierad miljö.

Åtgärda eller ta bort ogiltiga miljöer

Om Visual Studio hittar registerposter för en miljö, men sökvägen till tolken är ogiltig, visar fönstret Python-miljöer miljönamnet med ett teckensnittsformat med överstrykning, som visas i följande bild.

Om du vill korrigera en miljö som du vill behålla kan du först prova att använda miljöinstallationsprogrammets reparationsprocess . De flesta installationsprogram innehåller ett reparationsalternativ.

Ändra registret för att korrigera en miljö

Om Python-miljön inte har något reparationsalternativ eller om du vill ta bort en ogiltig miljö kan du använda följande steg för att ändra registret direkt. Visual Studio uppdaterar automatiskt Fönstret Python-miljöer när du gör ändringar i registret.

1. Kör regedit.exe för att öppna registereditorn.

2. Bläddra till den miljömapp som motsvarar konfigurationen:

   Python-version	Mapp
   64-bitversion	HKEY_LOCAL_MACHINE\SOFTWARE\Python eller HKEY_CURRENT_USER\Software\Python
   32-bitarsversion	HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Python
   IronPython	IronPython

3. Expandera distributions- och versionsnodstrukturen för din miljö:

   Fördelning	Node
   CPython	PythonCore><Version nod>
   Anakonda	ContinuumAnalytics><Versionsnod>
   IronPython	<Versionsnod>

4. Granska värdena under InstallPath-noden :

   

   • Om miljön fortfarande finns på datorn ändrar du värdet för posten ExecutablePath till rätt plats. Korrigera även värdena för posterna (Standard) och WindowedExecutablePath efter behov.
   • Om miljön inte längre finns på datorn och du vill ta bort den från Python-miljöfönstret tar du bort den överordnade noden för versionsnumret för InstallPath-noden . Du kan se ett exempel på den här noden i föregående bild. I exemplet är den här noden 3,6.

   Försiktighet

   Ogiltiga inställningar i HKEY_CURRENT_USER\SOFTWARE\Python-nyckeln åsidosätter inställningarna i HKEY_LOCAL_MACHINE\SOFTWARE\Python-nyckeln .

Radera eller ta bort en Python-miljö

Om du vill ta bort ett Python-projekt bläddrar du till Python-miljön i Solution Explorer. Högerklicka på Den Python-miljö som du vill ta bort och välj Ta bort.

Om du vill behålla Python-miljön men ta bort den från projektet väljer du Ta bort. Om du vill ta bort miljön permanent väljer du Ta bort.

Relaterat innehåll

• Installera Python-tolkar
• Välj en Python-miljö för ett projekt i Visual Studio
• Hantera nödvändiga Python-paket med requirements.txt
• Använda Python-mappar i Sökvägar i Visual Studio
• Fönsterreferens för Python-miljöer