Práce s interaktivním oknem Pythonu v sadě Visual Studio

Visual Studio poskytuje interaktivní okno smyčky REPL (read-evaluate-print) pro každé prostředí Pythonu, které se zlepšuje po získání rePL pomocí python.exe příkazu na příkazovém řádku. Interaktivní okno Pythonu umožňuje zadat libovolný kód Pythonu a zobrazit okamžité výsledky. Tento přístup k kódování vám pomůže naučit se a experimentovat s rozhraními API a knihovnami a interaktivně vyvíjet pracovní kód, který se má zahrnout do vašich projektů.

Snímek obrazovky s oknem smyčky REPL (Read-evaluate-print) v Pythonu Interactive v sadě Visual Studio 2022

Snímek obrazovky s oknem smyčky REPL (Read-evaluate-print) v Pythonu Interactive v sadě Visual Studio

Visual Studio má mnoho režimů PYTHON REPL, ze kterých si můžete vybrat:

REPL Popis Probíhají úpravy Ladění Obrázky
Standard Výchozí repl hovoří s Pythonem přímo Standardní úpravy (víceřádkové a další) Ano, prostřednictvím $attach No
Debug Výchozí rozhovory REPL s laděným procesem Pythonu Standardní úpravy Pouze ladění No
IPython RePL hovoří o back-endu IPythonu Příkazy IPythonu, pohodlí Pylabu No Ano, vložený v REPL
IPython bez Pylabu RePL hovoří o back-endu IPythonu Standardní IPython No Ano, samostatné okno

Tento článek popisuje režimy Standard a Debug REPL. Podrobnosti o režimech IPythonu najdete v tématu Použití IPython REPL.

Podrobný návod s příklady, včetně interakcí s editorem, jako je například Ctrl+Enter, najdete v tématu Použití interaktivního okna REPL.

Požadavky

Visual Studio pro Mac se v současné době nepodporuje. Další informace najdete v tématu Co se děje s Visual Studio pro Mac? Visual Studio Code ve Windows, Mac a Linuxu funguje dobře s Pythonem prostřednictvím dostupných rozšíření.

Otevření interaktivního okna

Interaktivní okno pro prostředí Pythonu můžete otevřít několika způsoby.

  • V okně Prostředí Pythonu:

    1. Výběrem možnosti Zobrazit>další prostředí Windows>Python otevřete okno Prostředí Pythonu (nebo použijte klávesu Ctrl+K>Ctrl).+`

    2. V okně Prostředí Pythonu vyberte prostředí a přepněte na stránku Přehled pro dané prostředí.

    3. Na stránce Přehled vyberte možnost Otevřít interaktivní okno.

    Snímek obrazovky znázorňující použití možnosti Otevřít interaktivní okno pro vybrané prostředí v sadě Visual Studio 2022

    Snímek obrazovky znázorňující použití možnosti Otevřít interaktivní okno pro vybrané prostředí v sadě Visual Studio

  • V nabídce Zobrazení v nástroji Visual Studio vyberte Jiné interaktivní okno Windows>Pythonu:

    Snímek obrazovky znázorňující použití možnosti nabídky Zobrazit interaktivní okno Pythonu v sadě Visual Studio 2022

    Snímek obrazovky, který ukazuje, jak v sadě Visual Studio použít možnost nabídky Zobrazit interaktivní okno Pythonu

  • V nabídce Ladění na panelu nástrojů sady Visual Studio vyberte Spustit <projekt | Soubor> v Pythonu Interactive nebo použijte klávesovou zkratku Shift+Alt+F5. Můžete otevřít interaktivní okno pro spouštěcí soubor v projektu nebo pro jakýkoli samostatný soubor:

    Snímek obrazovky, který ukazuje, jak v sadě Visual Studio 2022 použít možnost Ladit spustit projekt v pythonu Interactive

    Snímek obrazovky, který ukazuje, jak v sadě Visual Studio použít možnost Ladit spustit projekt v Pythonu Interactive

Další možností je odeslat kód, který píšete v editoru sady Visual Studio, do interaktivního okna. Tento přístup je popsaný v části Odeslat kód do interaktivního okna.

Prozkoumání možností interaktivního okna

Můžete řídit různé aspekty interaktivního okna, například umístění souborů spouštěcích skriptů a způsob fungování kláves se šipkami v prostředí okna. Pokud chcete získat přístup k možnostem, vyberte Možnosti>nástrojů>Python>Interactive Windows:

Snímek obrazovky s možnostmi Pythonu Interactive Windows v sadě Visual Studio

Možnosti jsou podrobně popsány v možnostech interaktivního okna Pythonu pro Visual Studio.

Použití interaktivního okna

V interaktivním okně můžete začít zadávat kód řádek po řádku na příkazovém řádku >>>REPL Pythonu . Při zadávání jednotlivých řádků Visual Studio spustí kód, včetně importu potřebných modulů a definování proměnných.

Když Visual Studio zjistí, že řádek kódu neformuje kompletní příkaz, kód se změní na pokračování ...REPL . Tato výzva značí, že k dokončení bloku příkazu je potřeba zadat další řádky kódu. Visual Studio čeká na zavírací syntaxi, než se pokusí spustit blok kódu.

Když definujete for příkaz, první řádek kódu spustí for blok a končí dvojtečku. Blok se může skládat z jednoho nebo více řádků kódu, které definují úkoly, které se mají dokončit během smyčky for . Když vyberete Enter na prázdném řádku, interaktivní okno zavře blok a Visual Studio spustí kód.

Porovnání REPL příkazového řádku

Interaktivní okno vylepšuje obvyklé prostředí REPL příkazového řádku Pythonu tím, že automaticky odsadí příkazy, které patří do okolního oboru. Oba přístupy umožňují procházet zadaný kód pomocí kláves se šipkami. Interaktivní okno také poskytuje víceřádkové položky, zatímco příkazový řádek REPL poskytuje pouze jeden řádek.

Meta-příkazy

Interaktivní okno podporuje několik meta příkazů. Všechny meta-příkazy začínají symbolem $dolaru . Zadáním můžete $help zobrazit seznam meta příkazů a $help <command> získat podrobnosti o využití konkrétního příkazu. Následující tabulka shrnuje meta-příkazy.

Příkaz meta Popis
$$ Vložte komentář, který je užitečný pro komentování kódu v celé relaci.
$cls, $clear Vymažte obsah okna editoru, ale ponechejte historii a kontext spuštění nedotčený.
$help Zobrazí seznam příkazů nebo nápovědu k určitému příkazu.
$load Načtěte příkazy ze souboru a spusťte je až do dokončení.
$mod Přepněte aktuální obor na zadaný název modulu.
$reset Obnovte spouštěcí prostředí do počátečního stavu, ale udržujte historii.
$wait Počkejte alespoň na zadaný počet milisekund.

Příkazy můžete také rozšířit o rozšíření sady Visual Studio implementací a exportem IInteractiveWindowCommand třídy. Další informace najdete v >příkladu na GitHubu.

Přepnout obor interaktivního okna

Ve výchozím nastavení je interaktivní okno projektu vymezeno na spouštěcí soubor projektu, jako kdybyste soubor programu spustili z příkazového řádku. U samostatného souboru je obor nastavený na tento soubor. Kdykoli během relace REPL můžete pomocí rozevíracího seznamu Rozsah modulu změnit obor:

Snímek obrazovky, který ukazuje, jak pomocí rozevírací nabídky Rozsah modulu změnit obor v interaktivním okně v sadě Visual Studio 2022

Snímek obrazovky, který ukazuje, jak pomocí rozevírací nabídky Obor modulu změnit obor v interaktivním okně

Po importu modulu, například import importlib, se v rozevírací nabídce rozsahu modulu zobrazí možnosti pro přepnutí do libovolného oboru v tomto modulu. Zpráva v interaktivním okně hlásí změnu nového oboru, abyste mohli sledovat, jak jste se dostali k určitému stavu během relace, a to kontrolou historie příkazů.

Pokud zadáte dir() příkaz do oboru, Visual Studio zobrazí v daném oboru platné identifikátory, včetně názvů funkcí, tříd a proměnných. Následující obrázek znázorňuje výsledek dir() příkazu pro importlib obor:

Snímek obrazovky znázorňující výstup v interaktivním okně pro obor importlib v sadě Visual Studio 2022

Snímek obrazovky znázorňující výstup v interaktivním okně pro obor importlibu

Odeslání kódu do interaktivního okna

Kromě přímé práce v interaktivním okně můžete do okna odeslat kód v editoru sady Visual Studio. Tento příkaz je užitečný pro iterativní nebo vývoj vývojového kódu, včetně testování kódu při jeho vývoji.

  1. Otevřete soubor kódu v editoru sady Visual Studio a vyberte některý nebo celý kód.

  2. Klikněte pravým tlačítkem myši na vybraný kód a vyberte Odeslat do Interaktivní (nebo použijte klávesovou zkratku Ctrl+E, E).

    Snímek obrazovky, který ukazuje, jak v sadě Visual Studio 2022 použít možnost nabídky Odeslat do interaktivního zobrazení

    Snímek obrazovky, který ukazuje, jak v sadě Visual Studio použít možnost nabídky Odeslat do interaktivního zobrazení

Úprava a spuštění kódu

Po odeslání kódu do interaktivního okna a zobrazení výstupu můžete upravit kód a otestovat změny. Pomocí šipek nahoru a dolů přejděte k kódu v historii příkazů okna. Upravte kód a spusťte aktualizovaný kód tak, že vyberete Ctrl+Enter.

Když provedete změny, vyberete-li klávesu Enter na konci kompletního příkazu kódu, Visual Studio tento kód spustí. Pokud příkaz kódu není dokončený, Visual Studio vloží do okna nový řádek.

Uložení kódu a odebrání výzev

Po dokončení práce na kódu můžete v interaktivním okně vybrat aktualizovaný kód a vložit ho zpět do souboru projektu a uložit práci.

Když do editoru vložíte kód z interaktivního okna , Visual Studio ve výchozím nastavení odebere příkazový řádek >>> REPL a příkazový řádek pokračování ... . Toto chování umožňuje snadno přenášet kód z okna do editoru.

Chování můžete změnit pomocí možnosti Vložit odebere výzvu REPL pro interaktivní okno:

  1. Výběrem možnosti nástroje>otevřete dialogové okno Možnosti.

  2. Rozbalte část Formátování Jazyka Python>v textovém editoru.>

  3. Zrušte zaškrtnutí políčka Vložit odebrat výzvy REPL.

  1. Výběrem možnosti nástroje>otevřete dialogové okno Možnosti.

  2. Rozbalte část Rozšířený textový editor>Pythonu.>

  3. Zrušte zaškrtnutí políčka Vložit odebrat výzvy REPL.

Když tuto možnost vymažete, znaky výzvy se zachovají v kódu vložené z okna. Další informace naleznete v tématu Možnosti – Různé možnosti.

Kontrola chování IntelliSense

Interaktivní okno obsahuje návrhy IntelliSense založené na živých objektech, na rozdíl od editoru kódu, ve kterém je IntelliSense založená pouze na analýze zdrojového kódu. Díky tomu jsou návrhy IntelliSense v interaktivním okně správnější, zejména s dynamicky generovaným kódem. Nevýhodou je, že funkce s vedlejšími účinky, jako jsou zprávy protokolování, můžou ovlivnit vaše vývojové prostředí.

Chování IntelliSense můžete upravit pomocí možností dokončování :

  1. Výběrem možnosti nástroje>otevřete dialogové okno Možnosti.

  2. Rozbalte část Interaktivní windows Pythonu.>

  3. Upravte nastavení ve skupině Režim dokončování, například Nikdy nevyhodnocovat výrazy nebo Skrýt návrhy statické analýzy.

Další informace naleznete v tématu Možnosti – Interaktivní možnosti Windows.