Výběr Python prostředí pro projekt v Visual Studio

Veškerý kód v projektu Pythonu běží v kontextu konkrétního prostředí. Tato prostředí můžou být globální Python prostředí, prostředí Anaconda, virtuální prostředí nebo prostředí conda. Visual Studio používá Pythonové prostředí k ladění, dokončování importů a členů a kontrole syntaxe. Prostředí se používá pro všechny úlohy, které vyžadují jazykové služby specifické pro verzi Pythonu a sadu nainstalovaných balíčků.

V Visual Studio můžete pro projekt vytvořit více prostředí a přepínat mezi nimi podle konkrétních potřeb vývoje. Všechny nové Python projekty jsou původně nakonfigurované tak, aby používaly výchozí globální prostředí. Prostředí vašeho projektu můžete zobrazit pod uzlem prostředí Pythonu v Průzkumníku řešení:

Požadavky

• Visual Studio. Pokud chcete nainstalovat produkt, postupujte podle kroků v části Instalace sady Visual Studio.

• Můžete přepínat pouze mezi existujícími prostředími. Pokud nemáte jiné prostředí než výchozí globální prostředí, přečtěte si následující části týkající se práce s virtuálními prostředími. Další informace najdete v tématu Vytváření a správa prostředí Pythonu v sadě Visual Studio.

Přepnutí aktuálního prostředí projektu

V Visual Studio můžete změnit aktivní (aktuální) prostředí pro projekt Python v Průzkumník řešení nebo z panelu nástrojů pomocí funkce Přidat prostředí.

1. Spusťte proces přidat prostředí :

   • V Průzkumník řešení klikněte pravým tlačítkem na uzel prostředí Python projektu a vyberte Přidat prostředí.
   • Nebo na panelu nástrojů Python vyberte Přidat prostředí z rozevírací nabídky Environment.

   

   

2. V dialogovém okně Přidat prostředí vyberte kartu Existující prostředí . Rozbalte rozevírací seznam Prostředí a zvolte požadované prostředí a pak vyberte Přidat.

   

Použití virtuálních prostředí

Virtuální prostředí je jedinečná kombinace konkrétního interpreta Python a konkrétní sady knihoven, které se liší od jiných globálních prostředí a prostředí conda. Virtuální prostředí je specifické pro projekt a udržuje se v podsložce projektu. Složka obsahuje nainstalované knihovny prostředí spolu se souborem pyvenv.cfg , který určuje cestu k interpretu základního prostředí v systému souborů. (Virtuální prostředí neobsahuje kopii interpreta, pouze odkaz na něj.)

Jednou z výhod používání virtuálního prostředí je, že při vývoji projektu v průběhu času bude virtuální prostředí vždy odpovídat přesným závislostem projektu. Toto chování se liší od sdíleného globálního prostředí, které obsahuje libovolný počet knihoven bez ohledu na to, jestli je používáte ve svém projektu nebo ne. Z virtuálního prostředí můžete snadno vytvořit souborrequirements.txt , který slouží k přeinstalaci závislostí balíčků na jiných vývojových nebo produkčních počítačích. Další informace naleznete v tématu Správa požadovaných balíčků pomocí requirements.txt.

Když otevřete projekt v Visual Studio, který obsahuje soubor requirements.txt, Visual Studio vám automaticky poskytne možnost znovu vytvořit virtuální prostředí. Na počítačích, kde není nainstalovaný Visual Studio, můžete k obnovení potřebných balíčků použít příkaz pip install -r requirements.txt.

Vzhledem k tomu, že virtuální prostředí obsahuje pevně zakódovanou cestu k základnímu interpretu Python a můžete prostředí znovu vytvořit pomocí souboru requirements.txt, obvykle vynecháte podsložku prostředí ze správy zdrojového kódu. Po přidání virtuálního prostředí do projektu se zobrazí v okně Python Environment. Pak ho můžete aktivovat stejně jako jakékoli jiné prostředí a spravovat jeho balíčky.

Vytvoření virtuálního prostředí

Nové virtuální prostředí můžete vytvořit přímo v Visual Studio následujícím způsobem:

1. Spusťte proces přidat prostředí :

   • V Průzkumník řešení klikněte pravým tlačítkem na uzel prostředí Python projektu a vyberte Přidat prostředí.
   • Nebo na panelu nástrojů Python vyberte Přidat prostředí z rozevírací nabídky Environment.

2. V dialogovém okně Přidat prostředí vyberte kartu Virtuální prostředí :

   

3. Nakonfigurujte požadovaná pole:

   Povinné pole	Description
   Projekt	Určete projekt, ve kterém se má prostředí vytvořit.
   Název	Zadejte název nového virtuálního prostředí.
   Základní interpret	Zadejte interpret základního jazyka pro virtuální prostředí.
   Location	Systém přiřadí virtuálnímu prostředí výchozí umístění. Pokud chcete umístění změnit, vyberte odkaz Změnit umístění virtuálního prostředí , přejděte do umístění a zvolte Vybrat složku.

4. Nakonfigurujte požadovaná volitelná pole:

   Volitelné pole	Description
   Instalace balíčků ze souboru	Zadejte cestu k souboru requirements.txt pro přidání balíčků do virtuálního prostředí. Zadejte umístění a název souboru nebo přejděte (...) do umístění a vyberte soubor.
   Nastavit jako aktuální prostředí	Po vytvoření prostředí aktivujte nové prostředí ve vybraném projektu.
   Nastavit jako výchozí prostředí pro nové projekty	Automaticky nastavte a aktivujte prostředí v jakýchkoli nových projektech vytvořených v Visual Studio. Toto nastavení je také dostupné prostřednictvím možnosti Nastavit jako výchozí prostředí pro nové projekty v okně Pythonová prostředí. Pokud použijete tuto možnost, umístěte virtuální prostředí do umístění mimo konkrétní projekt.
   Zobrazit v okně Pythonových prostředí	Zadejte, zda se má po vytvoření nového prostředí zobrazit okno Python prostředí.
   Zpřístupnit toto prostředí globálně	Určete, jestli má virtuální prostředí fungovat také jako globální prostředí. Pokud použijete tuto možnost, umístěte virtuální prostředí do umístění mimo konkrétní projekt.

5. Vyberte Vytvořit a dokončete virtuální prostředí.

Visual Studio během konfigurace prostředí zobrazí indikátor průběhu a stáhne všechny potřebné balíčky.

Po dokončení procesu Visual Studio aktivuje nové virtuální prostředí a přidá ho do uzlu Python Environment v uzlu Průzkumník řešení. Prostředí je také k dispozici v okně Python Environmenty pro projekt, který je obsahuje.

Aktivace prostředí

Pokud chcete aktivovat existující prostředí pro projekt, postupujte takto:

1. V Průzkumník řešení rozbalte uzel Python Prostředí projektu a vyhledejte prostředí, které chcete použít.

2. Klikněte pravým tlačítkem na prostředí a vyberte Aktivovat prostředí.

   

   

   Pokud Visual Studio v tomto prostředí zjistí soubor requirements.txt, zeptá se, jestli se mají tyto balíčky nainstalovat.

   Po Visual Studio aktivaci prostředí se název aktivního prostředí zobrazí tučným písmem v Průzkumník řešení:

   

   

Odstraňte virtuální prostředí

Pokud chcete odebrat existující prostředí pro projekt, postupujte takto:

1. V Průzkumník řešení klikněte pravým tlačítkem na virtuální prostředí a vyberte Remove.

2. Visual Studio se zeptáte, jestli chcete virtuální prostředí odebrat nebo odstranit.

   • Pokud chcete, aby prostředí bylo pro projekt nedostupné, ale nechte ho v systému souborů, vyberte Odebrat .
   • Výběrem možnosti Odstranit odeberete prostředí z projektu a odstraníte ho ze systému souborů. Základní interpret není ovlivněn.

Zobrazení a správa nainstalovaných balíčků

V Průzkumník řešení můžete zobrazit a spravovat balíčky nainstalované v prostředí. Tyto balíčky je možné importovat a používat v kódu, když je prostředí aktivní.

• Pokud chcete rychle zobrazit balíčky nainstalované v prostředí, rozbalte uzel prostředí v Python Prostředí pro váš projekt v Průzkumník řešení:

  

  

• Pokud chcete nainstalovat nové balíčky nebo spravovat existující balíčky, klikněte pravým tlačítkem na uzel prostředí a vyberte Manage Python Packages. Můžete také použít tlačítko balíčku na panelu nástrojů Python:

  

  

  Otevře se okno Python prostředí a zobrazí nainstalované balíčky pro vybrané prostředí na kartě Packages (PyPI):

  

  

  Ve Visual Studio se balíčky a závislosti pro většinu prostředí stáhnou z indexu balíčků Python (PyPI), kde můžete také vyhledat dostupné balíčky. stavový řádek Visual Studio a okno výstupu zobrazují informace o instalaci.

• Pokud chcete balíček odinstalovat (odebrat), vyhledejte balíček v seznamu a vpravo vyberte ikonu x .

• Pokud chcete vyhledat aktualizované verze balíčku nebo jiných balíčků, zadejte hledaný termín (obvykle název balíčku):

  Visual Studio zobrazí odpovídající balíčky. V tomto příkladu jde o hledání balíčků, které odpovídají výrazu blinker.

  

  

  Visual Studio zobrazí seznam odpovídajících výsledků jako aktivní příkazové odkazy.

  • První příkaz aktualizuje balíček na nejnovější verzi a aktuální závislosti. Příkaz je podobný Run command: pip install <package-name>příkazu . Pokud vyberete Enter za hledaný termín, Visual Studio tento první příkaz automaticky spustí.

  • Další odkazy jsou určené pro příkazy, které nainstalují určitý balíček, verzi nebo závislost, například Install blinker-async (0.0.3). Pokud chcete spustit jeden z těchto příkazů, vyberte odkaz.

Důležité informace o instalaci balíčku

Při práci s balíčky v Visual Studio mějte na paměti následující aspekty:

• Mějte na paměti, že zobrazené položky balíčků nemusí být přesné z hlediska nejaktuálnější verze nebo dostupnosti. Informace o instalaci a odinstalaci zobrazené pro balíček nemusí být spolehlivé nebo dostupné.

• Visual Studio pokud je k dispozici, použije správce balíčků pip a podle potřeby ho stáhne a nainstaluje. Visual Studio může také použít správce balíčků easy_install. Balíčky nainstalované pomocí příkazů pip z příkazového řádku easy_install jsou také zobrazeny.

• Běžnou situací, kdy pip nenainstaluje balíček, je situace, kdy balíček obsahuje zdrojový kód pro nativní komponenty v souborech *.pyd . Bez nainstalované požadované verze Visual Studio nemůže pip tyto komponenty zkompilovat. Chybová zpráva zobrazená v této situaci je chyba: Nelze najít vcvarsall.bat. Příkaz easy_install často dokáže stáhnout předkompilované binární soubory a můžete stáhnout vhodný kompilátor pro starší verze Python z https://python.en.uptodown.com/windows/versions. Další informace najdete v tématu Jak řešit potíže s nemožností najít vcvarsallbat na blogu týmu Python tools.

• Správce balíčků Conda obecně používá https://repo.continuum.io/pkgs/ jako výchozí kanál, ale jsou k dispozici i jiné kanály. Další informace najdete v tématu Správa kanálů (docs.conda.io).

• Visual Studio aktuálně nepodporuje použití příkazu conda k instalaci balíčků do prostředí conda. conda Místo toho použijte příkaz z příkazového řádku.

Související obsah

• Správa prostředí Pythonu v sadě Visual Studio
• Použijte requirements.txt pro závislosti
• Cesty pro hledání
• Referenční okno prostředí Pythonu