Referenční informace: Rozšíření sady Azure Quantum Development Kit pro Visual Studio Code

Sada Azure Quantum Development Kit (QDK) používá při práci se soubory .qs všechny standardní funkce editoru Visual Studio (VS) Code spolu s funkcemi specifické pro Q#. Tento článek je referenčním průvodcem pro všechny příkazy a funkce související s jazykem Q# s odkazy na další obsah podle potřeby. Obecné pokyny pro VS Code najdete v dokumentaci k VS Code.

Tip

Většina příkazů souvisejících s jazykem Q# je přístupná z > nabídky Zobrazit paletu příkazů. V souboru .qs vyberte Kombinaci kláves Ctrl-Shift-P (Cmd-Shift-P v macOS) a zadáním Q# zobrazte filtrovaný seznam příkazů.

Všechny klávesové zkratky pro macOS najdete v tématu Klávesové zkratky pro macOS.

Příkazy

Většina příkazů souvisejících s jazykem Q# je přístupná z > nabídky Zobrazit paletu příkazů. Vyberte Kombinaci kláves Ctrl-Shift-P a zadáním Q # zobrazíte filtrovaný seznam příkazů. Některé příkazy jsou k dispozici pouze v případech, kdy je aktivní soubor .qs.

Tip

Vlastní klávesové zkratky můžete vytvořit pro libovolný příkaz VS Code pomocí klávesových zkratek nebo Ctrl+K+S. Další informace naleznete v tématu Klíčové vazby pro VS Code.

Příkaz	Akce	Notes	Alternativní akce uživatele
Q#: Vytvoření projektu Q#	Vytvoří projekt Q# v aktivní složce, včetně: * soubor manifestu qsharp.json * podsložka src s výchozím souborem main.qs.	Další informace o projektech Q# najdete v tématu Práce s projekty Q#.	V Průzkumník souborů klikněte pravým tlačítkem na cílovou složku a vyberte Vytvořit projekt Q#.
Q#: Vytvoření poznámkového bloku Azure Quantum	Otevře ukázkový poznámkový blok Jupyter, který spustí program Q# + Python a odešle úlohu do Azure Quantum.	Další informace o poznámkových blocích Azure Quantum najdete v tématu Práce s poznámkovými bloky Azure Quantum.	–
Q#: Připojení k pracovnímu prostoru Azure Quantum	Připojte se k pracovnímu prostoru Azure Quantum pomocí účtu Azure nebo připojovací řetězec. Po ověření se pracovní prostor zobrazí v Průzkumník souborů v pracovních prostorech Quantum.	Další informace o připojeních Azure Quantum najdete v tématu Připojení k pracovnímu prostoru Azure Quantum.	V Průzkumník souborů najeďte myší na pracovní prostory Quantum a vyberte ikonu +.
Q#: Otevření dětského hřiště Q#	Otevře online složku ukázkových programů q# v Průzkumník souborů. Programy můžete upravovat a spouštět v místním kvantovém simulátoru a také nastavit zarážky a procházet kód pomocí integrovaného ladicího programu.	Další informace najdete v souboru README v ukázkové složce.	–
Q#: Aktualizace pracovních prostorů Azure Quantum	Synchronizuje nejnovější změny z připojených kvantových pracovních prostorů.	Pokud dojde k problému s připojením, zobrazí se vedle názvu pracovního prostoru ikona upozornění.	V Průzkumník souborů najeďte myší na pracovní prostory Quantum a vyberte ikonu aktualizace.
Průzkumník: Zaměření na zobrazení kvantových pracovních prostorů	Otevře Průzkumník souborů a zaměřuje se na připojené kvantové pracovní prostory, pokud jsou nakonfigurované. Pokud nejsou nakonfigurované žádné pracovní prostory, zobrazí se výzva k přidání existujícího pracovního prostoru.	Další informace o připojeních Azure Quantum najdete v tématu Připojení k pracovnímu prostoru Azure Quantum.	–

Pokud je aktivní soubor .qs, jsou k dispozici následující příkazy.

Příkaz	Akce	Notes	Alternativní akce uživatele
Q#: Nastavení cílového profilu Azure Quantum QIR	Nastaví cílový profil QIR nebo kvantového zprostředkujícího znázornění pro vaše programy v Q#.	Další informace o cílových profilech najdete v tématu Cílové profily.	Aktuální cílový profil se zobrazí na dolním panelu nástrojů. Výběrem cílového profilu na panelu nástrojů otevřete rozevírací seznam výběru.
Q#: Zobrazení okruhu	Zobrazí diagram okruhu pro program Q# před spuštěním.	Další informace najdete v tématu Vizualizace diagramů kvantových obvodů.	V nabídce vedle operace vstupního bodu nebo nad každou uživatelsky definovanou operací v programu vyberte možnost Okruh kódu.
Q#: Spuštění souboru a zobrazení histogramu	Spustí aktuální program Q# a zobrazí histogram výsledků v pravém podokně.	Pokud chcete získat přístup k možnostem řazení a filtrování pro zobrazení histogramu, vyberte ikonu filtru v podokně histogramu.	V nabídce vedle operace vstupního bodu vyberte histogram s možností objektivu kódu.
Q#: Získání QIR pro aktuální program Q#	Otevře zdroj QIR pro aktuální kód Q# v novém okně pro úpravy. K exportu zdroje QIR musí váš program použít cílový profil základního nebo adaptivního riu.	Další informace o QIR naleznete v tématu Kvantové zprostředkující reprezentace a blog pro vývojáře v Q#.	–
Ladění: Ladění souboru Q#	Otevře aktuální program Q# v ladicím programu.	Další informace najdete v tématu Ladění a testování kvantového kódu.	* Vyberte F5 * Vyberte možnost Kód objektivu Ladit z nabídky vedle operace vstupního bodu. * Vyberte ikonu Spustit v pravém horním rohu a vyberte Ladit soubor Q#.
Ladění: Spuštění souboru Q#	Spustí aktuální program Q# ve výchozím kvantovém simulátoru.	Další informace najdete v tématu Začínáme s programy q#.	* Vyberte Ctrl+F5 * Vyberte možnost Objektiv kódu spustit z nabídky vedle operace vstupního bodu. * Vyberte ikonu Spustit v pravém horním rohu a vyberte Spustit soubor Q#.
Q#: Výpočet odhadů prostředků	Vyvolá integrovanou verzi estimátoru prostředků.	Další informace najdete v tématu Úvod do estimátoru prostředků Azure Quantum.	–
Q#: Nápověda	Stručný přehled rozšíření QDK v editoru VS Code	Kompletní dokumentaci k Azure Quantum najdete v dokumentaci k Azure Quantum.	–
Q#: Spuštění souboru a zobrazení diagramu okruhu	Spustí aktuální program Q# a zobrazí okruh programu s výstupy.	Další informace najdete v tématu Vizualizace diagramů kvantových obvodů.	–
Q#: Zobrazení dokumentace k rozhraní API	Otevře dokumentaci k rozhraní API v novém podokně. Prohledat toto podokno pomocí ctrl-F	Další informace najdete v referenčních informacích k rozhraní AZURE Quantum API.	–

Terminály

Programy v Q# používají v editoru VS Code dvě terminálová okna:

Terminál	Akce
Konzola ladění	Zobrazí výstup spuštění nebo výstup ladění.
Problémy	Zobrazí kontroly chyb před kompilací.

Úpravy kódu Q#

Většina běžných funkcí pro úpravy kódu v editoru VS Code je k dispozici při práci s programy q#. Další informace najdete v intellisense v dokumentaci k editoru VS Code.

• Kontrola chyb předkompilu
• Přejít k definici
• Reference
• Podpisy funkcí
• Informace o parametru
• Návrhy dokončení
• Linting – V souborech Q# nakonfigurujete lintování pro jednotlivé projekty v souboru manifestu. Další informace najdete v tématu Práce s projekty Q#.

Běžné úkoly

Práce se soubory a projekty Q#

Úloha	Akce	Notes
Nový soubor Q#	Vyberte Soubor > Nový textový soubor>. Uložte soubor s příponou .qs.	Pokud nastavíte Files: Default Language = qsharp, automaticky se automaticky nastaví nové formátování souborů na Q#.
Vytvoření projektu Q#	V otevřené složce v Průzkumník souborů vyberte Vytvořit projekt Q# z palety příkazů nebo klikněte pravým tlačítkem na složku v Průzkumník souborů a vyberte Vytvořit projekt Q#.	Další informace o projektech Q# najdete v tématu Práce s projekty Q#.
Ukázkové soubory	Do prázdného souboru .qs zadejte ukázky a pak ze seznamu vyberte ukázkový program.	Na paletě příkazů můžete také vybrat Otevřít dětské hřiště Q#, abyste v Průzkumník souborů otevřeli online složku ukázkových programů q#.

Připojení k Azure Quantum

Úloha	Akce	Notes	Alternativní akce uživatele
Připojení k pracovnímu prostoru Azure Quantum	V Průzkumník souborů rozbalte pracovní prostory Quantum a vyberte Přidat existující pracovní prostor. Podle pokynů vyberte předplatné a pracovní prostor.	* Můžete se připojit k více pracovním prostorům. Pokud chcete připojit jiný pracovní prostor, vyberte + vedle pracovních prostorů Quantum. Připojení pracovních prostorů se uchovávají mezi relacemi VS Code. * Chcete-li odebrat připojení pracovního prostoru, klikněte pravým tlačítkem myši na pracovní prostor a vyberte Odebrat připojení pracovního prostoru.	Na paletě příkazů vyberte Připojit k pracovnímu prostoru Azure Quantum.
Připojení programově pomocí programu v Pythonu	Klikněte pravým tlačítkem na existující připojení pracovního prostoru a vyberte Kopírovat kód Pythonu pro připojení k pracovnímu prostoru. Vložte výsledný kód do programu v Pythonu.	Další informace najdete v tématu Odesílání Pythonu s úlohami Q# do Azure Quantum.	–

Spouštění programů

Úloha	Akce	Notes	Alternativní akce uživatele
Spuštění programu Q# v místním kvantovém simulátoru	V programu Q# vyberte ikonu Spustit v pravém horním rohu a vyberte Spustit soubor Q#.	Další informace o kvantovém simulátoru najdete v řídkém kvantovém simulátoru.	* Vyberte Ctrl-F5 * Na paletě příkazů vyberte Q#: Spustit soubor a zobrazit histogram nebo Q#: Spustit soubor a zobrazit diagram okruhu * Vyberte možnost Objektiv kódu spustit z nabídky vedle operace vstupního bodu.
Ladění programu	V programu Q# vyberte ikonu Spustit v pravém horním rohu a vyberte Ladit soubor Q#.	Další informace o ladicím programu Q# ve VS Code najdete v tématu Ladění a testování kvantového kódu.	* Vyberte F5 * Vyberte možnost Kód objektivu Ladit z nabídky vedle operace vstupního bodu.
Zobrazení poskytovatelů a cílů v pracovních prostorech	V Průzkumník souborů vyberte pracovní prostory Quantum, rozbalte pracovní prostor a potom rozbalte zprostředkovatele, abyste viděli dostupné zprostředkovatele v pracovním prostoru. Rozbalte jednotlivého zprostředkovatele a zobrazte dostupné cíle.	Poznámka: Najeďte myší na cílový název, abyste před odesláním úlohy zobrazili jeho stav a čas fronty.	–
Odeslání úlohy do Azure Quantum	V programu Q# vyberte pracovní prostor, poskytovatele a cíl. Pokud chcete odeslat aktuální program Q#, vyberte šipku vedle cíle.	Další informace najdete v tématu Odesílání úloh Q# do Azure Quantum.	–
Zobrazení výsledků úlohy	Rozbalte pracovní prostor a potom rozbalte položku Úlohy. Pokud chcete otevřít výstup úlohy ze služby Azure Storage, vyberte ikonu cloudu vedle názvu úlohy.	Úlohy jsou uvedené s nejnovějšími nahoře.	–