Možnosti pythonu v sadě Visual Studio

Visual Studio poskytuje podporu pro konfiguraci interaktivního vývojového prostředí (IDE) pro vývoj v Pythonu. Možnosti můžete nastavit podle svých preferencí a splnit konkrétní potřeby vývojového prostředí. Tento článek popisuje možnosti, které jsou k dispozici pro obecné rozložení a chování, ladění, diagnostiku a pokročilé jazykové funkce Pythonu.

Umístění možností Pythonu

Nastavení konfigurace Pythonu jsou k dispozici na panelu nástrojů sady Visual Studio v částiMožnosti>. Dialogové okno Možnosti obsahuje seznam většiny nastavení Pythonu na kartě Python :

Můžete nakonfigurovat předvolby pro ladění, analýzu serveru jazyka Pylance, prostředí conda, obecné prostředí a Interaktivní windows.

V podokně Možnosti jsou uvedeny další nastavení Pythonu v části Všechnyjazyky>nastavení>Pythonu. K dispozici jsou možnosti posuvníků, záložek a formátování a také obecná a rozšířená nastavení. Další nastavení jsou k dispozici v části Prostředí>Písma a barvy pro skupinu nastavení textového editoru.

Poznámka:

Dialogové okno Možnosti může obsahovat experimentální kartu nebo skupinu pro funkce ve vývoji, které nejsou popsané v tomto článku. Další informace najdete v příspěvcích o technikách Pythonu na blogu Microsoftu.

Konkrétní možnosti pro Python

V částiMožnosti>nástrojů>v Pythonu můžete nastavit možnosti specifické pro Python pro obecné prostředí, včetně interaktivních prostředí Windows, prostředí conda, ladění a dalších možností.

Obecné možnosti Pythonu

Následující možnosti jsou k dispozici v části Nástroje>,Možnosti>Python>Obecné:

Možnost	Výchozí	Description
Zobrazení okna výstupu při vytváření virtuálních prostředí	On	Pokud chcete zabránit zobrazení okna Výstup , zrušte zaškrtnutí políčka.
Zobrazit okno výstupu při instalaci nebo odebírání balíčků	On	Pokud chcete zabránit zobrazení okna Výstup , zrušte zaškrtnutí políčka.
Zobrazení panelu oznámení pro vytváření prostředí	On	Když nastavíte a otevřete projekt s requirements.txt nebo environment.yml souborem, Visual Studio zobrazí informační panel s návrhy pro vytvoření virtuálního prostředí nebo prostředí Conda místo použití výchozího globálního prostředí.
Zobrazení oznamovacího pruhu pro instalaci balíčků	On	Když nastavíte a otevřete projekt s requirements.txt souborem, který nepoužívá výchozí globální prostředí), Visual Studio tyto požadavky porovná s balíčky nainstalovanými v aktuálním prostředí. Pokud nějaké balíčky chybí, visual Studio zobrazí výzvu k instalaci těchto závislostí.
Zobrazení panelu oznámení pro konfiguraci testovací architektury	On	Pokud je nastaveno, Visual Studio při identifikaci souborů ve vašem Python projektu, které mohou obsahovat testy, ale není povolen žádný testovací rámec, vás vyzve k povolení frameworku pytest nebo unittest.
Vždy spouštět správce balíčků jako správce	Off	Vždy zvýší úroveň pip install a podobné operace správce balíčků pro všechna prostředí. Při instalaci balíčků sada Visual Studio vyzve k zadání oprávnění správce, pokud se prostředí nachází v chráněné oblasti systému souborů, jako je c:\Program Files. V této výzvě se můžete rozhodnout, že chcete vždy zvýšit úroveň instalačního příkazu pouze pro dané jedno prostředí. Další informace najdete na kartě Balíčky.

Možnosti prostředí Conda

Následující možnosti jsou k dispozici v částiMožnosti>nástrojů>Python>Conda:

Možnost	Výchozí	Description
Cesta ke spustitelnému souboru Conda	(prázdné)	Určuje přesnou cestu ke spustitelnému souboru conda.exe místo aby se spoléhalo na výchozí instalaci Miniconda, která je součástí úlohy Pythonu. Pokud je zde uvedena jiná cesta, má přednost před výchozí instalací a všemi dalšími conda.exe spustitelnými soubory zadanými v registru. Toto nastavení můžete změnit, pokud ručně nainstalujete novější verzi Anaconda nebo Miniconda nebo chcete místo výchozí 64bitové distribuce použít 32bitovou distribuci.

Možnosti ladění

V části Nástroje>Možnosti>ladění> jsou k dispozici následující možnosti:

Možnost	Výchozí	Description
Vyžádat potvrzení před spuštěním, pokud jsou přítomny chyby	On	Pokud je tato možnost nastavená, sada Visual Studio vás vyzve k potvrzení, že chcete spustit kód s chybami. Pokud chcete upozornění zakázat, zrušte zaškrtnutí této možnosti.
Čekání na vstup při neobvyklém ukončení procesu Čekat na vstup, když se proces ukončí normálně	Zapnuto (pro oba)	Program Pythonu spuštěný ze sady Visual Studio běží v samostatném okně konzoly. Ve výchozím nastavení okno čeká, až stisknete klávesu, a to bez ohledu na to, jak program ukončí. Pokud chcete tento příkaz odebrat a okno zavřít automaticky, zrušte zaškrtnutí obou těchto možností.
Přesměrování výstupu programu tee do okna pro ladicí výstup	On	Zobrazí výstup programu v samostatném okně konzoly i v okně Výstup sady Visual Studio. Pokud chcete zobrazit výstup pouze v samostatném okně konzoly, zrušte zaškrtnutí této možnosti.
Přerušení výjimky SystemExit s ukončovacím kódem nuly	Off	Pokud je nastavena, ladicí program se zastaví na této výjimce. Když je ladicí program ve stavu volného běhu, ukončí se bez přerušení.
Povolení ladění standardní knihovny Pythonu	Off	Umožňuje přejít ke zdrojovému kódu standardní knihovny při ladění, ale zvyšuje dobu potřebnou ke spuštění ladicího programu.
Zobrazení návratové hodnoty funkce	On	Zobrazí návratové hodnoty funkce v okně Místní a následně přeskočí volání funkce v ladicím programu (F10).
Zobrazit proměnné	On	Zobrazí čtyři skupiny proměnných, které se mají zobrazit a jak formátovat zobrazení (Group, Hide, Inline). - Třída: Výchozí hodnota je Group - Chráněno: Výchozí hodnota je "Inline". - Funkce: Výchozí hodnota je Group - Speciální: Výchozí hodnota je Skupina.

Možnosti analýzy

V části Nástroje>možnosti>analýzy> jsou k dispozici následující možnosti:

Možnost	Výchozí	Description
Režim diagnostiky	Otevřít jenom soubory	Určuje, jaké soubory kódu jazykový server analyzuje kvůli problémům, včetně pracovních prostorů a pouze otevřených souborů.
Úroveň protokolu	Information	Určuje úroveň protokolování, kterou má server jazyka provést. Mezi možné úrovně protokolování, v pořadí od nejnižšího po nejvyšší množství poskytovaných informací, patří: Chyba, Upozornění, Informace a Trasování.
Kontrola typu	Off	Určuje úroveň analýzy kontroly typů, která se má provést: - Vypnuto: Generování nevyřešené diagnostiky importů a proměnných, ale neprovádějte analýzu kontroly typů. - Základní: Používejte netypová pravidla (všechna pravidla na úrovni Off ) a také základní pravidla související s kontrolou typů. - Striktní: Použijte všechna pravidla kontroly typů s nejvyšší úrovní závažnosti chyb, včetně všech pravidel, která jsou na úrovni Vypnuto a Základní.
Formát importu	Absolutní	Definuje výchozí formát při automatickém importu modulů, včetně absolutního nebo relativního.
Cesta k zástupům	<Prázdný>	Určuje cestu k adresáři, který obsahuje zástupce vlastního typu. Očekává se, že typové soubory zástupů pro každý balíček budou ve vlastním podadresáři.
Cesty pro hledání	<Prázdný>	Určuje cesty pro vyřešení importů. Přijímá cesty zadané jako řetězce a oddělené čárkami, pokud existuje více cest, například ["path 1","path 2"].
Cesty typu Typehed	<Prázdný>	Určuje cesty pro Visual Studio, které umožní používat vlastní soubory Typeshed místo jeho sbalené verze.
Automatické přidání běžných cest hledání, jako je src	On	Určuje, zda se mají automaticky přidávat cesty hledání na základě předdefinovaných názvů, například src.
Index nainstalovaných knihoven třetích stran a uživatelských souborů pro jazykové funkce, jako je automatický import, přidání importu, symbolů pracovního prostoru atd.	Off	Určuje, jestli má jazykový server indexovat uživatelské soubory a nainstalovat knihovny třetích stran při spuštění. Index poskytuje ucelenější sadu symbolů ve funkcích, včetně automatických importů, rychlých oprav, automatických dokončování atd. – Při nastavení visual Studio indexuje symboly nejvyšší úrovně nainstalovaných balíčků, jako jsou symboly ve všech položkách balíčku/__init__.py, spolu se všemi symboly z až 2 000 uživatelských souborů. – Pokud není nastaveno, Visual Studio zobrazí symboly odkazované nebo použité v souborech, které byly dříve otevřeny nebo načteny editorem.

Interaktivní možnosti Windows

Následující možnosti jsou k dispozici pod nástroje>Možnosti>Python>interaktivní okna:

Možnost	Výchozí	Description
skripty	není k dispozici	Určuje obecnou složku pro spouštěcí skripty, které se použijí pro interaktivní windows pro všechna prostředí. Další informace naleznete v tématu Spouštěcí skripty. Poznámka: Tato funkce nemusí ve vaší verzi sady Visual Studio fungovat.
Pohyb v historii pomocí šipek nahoru/dolů	On	Pomocí kláves se šipkami můžete procházet historii v interaktivním okně. Pokud chcete místo toho přejít ve výstupu interaktivního okna, zrušte zaškrtnutí tohoto nastavení.
Režim dokončení	Vyhodnocení výrazů pouze bez volání funkce	Proces určení dostupných členů ve výrazu v interaktivním okně může vyžadovat vyhodnocení aktuálního nedefinovaného výrazu, což může mít za následek vícenásobné vyvolání vedlejších účinků nebo funkcí. Výchozí nastavení vyhodnocuje pouze výrazy bez volání funkce , vyloučí výrazy, které se jeví jako volání funkce, ale vyhodnotí jiné výrazy. Například vyhodnocuje příkaz a.b , ale ne a().b příkaz. Nikdy nevyhodnocujte výrazy , aby se zabránilo všem vedlejším účinkům, přičemž se využívá pouze normální modul IntelliSense k návrhům. Vyhodnotí všechny výrazy pro získání návrhů bez ohledu na vedlejší účinky.
Skrytí návrhů statické analýzy	Off	Při nastavení zobrazí pouze návrhy získané vyhodnocením výrazu. Pokud je použit režim Dokončování s hodnotou Nikdy nevyhodnocovat výrazy, v okně Interaktivní se nezobrazí žádné užitečné dokončení.

Jazykové možnosti pro Python

V části Všechny jazyky> nastavení >Pythonu jsou k dispozici možnosti posuvníků, karet a formátování spolu s obecnými a rozšířenými nastaveními:

Obecné možnosti editoru Pythonu

Následující jazykové možnosti Pythonu jsou k dispozici v části Obecné .

Poznámka:

Mnoho z následujících možností lze nastavit na globální úrovni pro všechny jazyky. Globální nastavení jsou v části Všechna nastavení>Jazyky>Výchozí>Obecné.

Možnost	Výchozí	Description
Povolení virtuálního prostoru	Off	Při nastavení vloží mezery na konec každého řádku kódu. Tuto možnost vyberte, pokud chcete komentáře umístit v konzistentním bodě vedle kódu. Režim virtuálního prostoru je povolený v režimu výběru sloupců . Pokud není povolený režim virtuálního prostoru , kurzor se přesune od konce jednoho řádku přímo na první znak dalšího řádku.
Zalamování slov	Off	Tuto možnost nastavte tak, aby se dlouhé řádky kódu mohly zalamovat na základě šířky oblasti zobrazení editorů.
Zobrazit vizuální glyfy pro zalamování slov	Off	Pokud je povolená možnost zalamování aplikace Word , nastavte tuto možnost tak, aby zobrazovala vizuální glyfy.
Čísla řádků	On	Nastavte tuto možnost tak, aby se čísla řádků zobrazovala na levém okraji editoru pro každý řádek kódu.
Povolení navigace na adrese URL jedním kliknutím	On	Po nastavení můžete jednou kliknout na adresu URL a přejít do cílového umístění.
Zobrazit rychlé informace po najetí myší	On	Když je nastaveno, Visual Studio zobrazuje rychlé informace o klíčovém slově, zatímco kurzor je nad elementem kódu.
Automatické dokončování závorek	On	Pokud je nastaveno, Visual Studio automaticky přidá koncovou složenou závorku ke každé otevřené složené závorce při zadávání kódu.
Použít vyjmutí nebo kopírování na prázdné řádky, pokud není vybrán žádný text	On	Visual Studio ve výchozím nastavení vyjme nebo zkopíruje celý řádek kódu, pokud neexistuje explicitní výběr. Tuto možnost použijte k povolení nebo zakázání tohoto chování vyjmutí nebo kopírování, když je vyvoláno na prázdných řádcích.

Další informace naleznete v tématu Možnosti: Obecný textový editor>.

Pokročilé možnosti editoru Pythonu

V části Nástroje>Možnosti>textového editoru>Python>Advanced jsou k dispozici následující možnosti:

Možnost	Výchozí	Description
Nabídka dokončování automatického importu	On	Pokud je nastavena, Visual Studio umožňuje automatické importy pro dokončování.
Automatické přidávání závorek pro funkce	Off	Při nastavení Visual Studio automaticky přidá kulaté závorky pro funkce při zadávání kódu v editoru.

Možnosti písem a barev

Další možnosti Pythonu jsou k dispozici v částiPísma a barvy>, pokud je skupina Textový editor nastavená na Python:

Názvy možností Pythonu mají předponu Python a jsou vysvětlované. Výchozí písmo pro všechny barevné motivy sady Visual Studio je Consolas 10 pt regular (bez tučného řezu). Výchozí barvy se liší podle motivu. Obvykle změníte písmo nebo barvu, aby se text snadněji četl.