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

Při práci se soubory .qs nebo .qasm používá Microsoft Quantum Development Kit (QDK) standardní funkce Visual Studio Code (VS Code), spolu s funkcemi specifickými pro jazyk. Tato referenční příručka popisuje všechny příkazy QDK, ke kterým máte přístup v paletě příkazů VS Code, spolu s dalšími funkcemi a odkazy na další obsah. Obecné pokyny pro VS Code najdete v dokumentaci k VS Code.

Tip

Většina příkazů z rozšíření QDK je přístupná z nabídky Paleta příkazů zobrazení>. Ve .qs nebo .qasm souboru otevřete paletu příkazů a zadejte QDK: pro zobrazení filtrovaného seznamu příkazů.

Commands

Většina příkazů QDK souvisí s psaním a spouštěním programů Q# a OpenQASM, a jsou k dispozici pouze v případě, že je aktivní soubor .qs nebo .qasm. Jiné příkazy fungují na pozadí a nejsou přístupné v paletě příkazů.

Následující tabulka popisuje příkazy z rozšíření QDK, které se zobrazí v paletě příkazů.

Tip

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

Command	Action	Poznámky	Alternativní akce uživatele
QDK: Vytvoření projektu Q#	Vytvoří projekt Q# v aktivní složce, včetně souboru manifestu qsharp.json a podsložky 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íku souborů klikněte pravým tlačítkem na cílovou složku a vyberte Vytvořit projekt Q#.
QDK: Vytvoření poznámkového bloku Microsoft Quantum	Otevře ukázkový poznámkový blok Jupyter, který spustí program Q# + Python a odešle úlohu do Azure Quantum.	Další informace o sadě QDK v Jupyter Notebook najdete v tématu Odesílání úloh do Azure Quantum pomocí balíčku Python sady QDK.	N/A
QDK: Připojení k pracovnímu prostoru Azure Quantum	Připojte se k pracovnímu prostoru Azure Quantum pomocí účtu Azure nebo připojovacího řetězce. Po přihlášení vyberte ikonu panelu Microsoft Quantum (vlevo dole).	Další informace o připojeních Azure Quantum najdete v tématu Připojení k pracovnímu prostoru Azure Quantum.	Najeďte myší na pracovní prostory Quantum a vyberte ikonu +.
QDK: Otevření dětského hřiště QDK	Otevře online složku s ukázkovými programy Q# a OpenQASM v Průzkumníkovi 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.	N/A
QDK: 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í.	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.	N/A

Následující příkazy jsou k dispozici, když je aktivní soubor .qs nebo .qasm.

Command	Action	Poznámky	Alternativní akce uživatele
QDK: Zobrazit obvod	Zobrazí schéma zapojení pro program 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 Circuit v rámci Code Lens.
QDK: Spuštění souboru a zobrazení histogramu	Spustí aktuální program a zobrazí histogram výsledků v nové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 možnost Histogram z CodeLens.
QDK: Získání QIR pro aktuální program QDK	Otevře zdroj QIR pro aktuální kód Q# nebo OpenQASM v novém okně pro úpravy. K exportu zdroje QIR musí váš program použít cílový profil Base, Adaptive RI nebo Adaptive RIF.	Další informace o QIR naleznete v tématu Kvantové zprostředkující reprezentace a blog pro vývojáře QDK.	N/A
QDK: 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ů Microsoft Quantum.	N/A
QDK: Nápověda	Stručný přehled rozšíření QDK v editoru VS Code	Kompletní dokumentaci k Microsoft Quantum najdete v dokumentaci k Microsoft Quantum.	N/A
QDK: Spuštění souboru a zobrazení diagramu okruhu	Spustí aktuální program a zobrazí okruh programu s výstupy.	Další informace najdete v tématu Vizualizace diagramů kvantových obvodů.	N/A
QDK: Zobrazení dokumentace k rozhraní API	Otevře dokumentaci k rozhraní API v novém podokně. Pokud chcete hledat v tomto podokně, stiskněte Ctrl+F.	Další informace najdete v referenčních informacích k rozhraní Microsoft Quantum API.	N/A
QDK: Zobrazit protokol změn	Otevře protokol změn na nové kartě, na které se zobrazují aktualizace sady QDK pro aktuální a předchozí verze.	Protokol změn je také k dispozici v opensourcovém úložišti QDK GitHub.	N/A
Ladění: Spuštění ladění	Otevře aktuální program v ladicím nástroji.	Další informace najdete v tématu Ladění a testování kvantového kódu.	Stiskněte klávesu F5 nebo vyberte možnost Ladění kódu z nabídky vedle operace vstupního bodu nebo vyberte ikonu Spustit v pravém horním rohu a zvolte Spustit ladění.
Ladění: Spustit	Spustí aktuální program ve výchozím kvantovém simulátoru.	Další informace najdete v tématu Začínáme s programy v Q#.	Stiskněte Ctrl + F5 nebo vyberte možnost Spustit funkci CodeLens z nabídky vedle operace vstupního bodu, nebo vyberte ikonu Spustit v pravém horním rohu a spusťte Spustit.

Terminály

Programy Q# a OpenQASM používají ve VS Code dvě terminálová okna:

Terminal	Action
Konzola ladění	Zobrazí výstup spuštění nebo výstup ladění.
Problémy	Zobrazí kontroly chyb před kompilací.

Úprava kódu Q# a OpenQASM

Většina běžných funkcí pro úpravy kódu v editoru VS Code je dostupná také při práci s programy Q# a OpenQASM:

• Kontrola chyb předkompilu
• Přejít k definici
• Odkazy
• Podpisy funkcí
• Informace o parametru
• Návrhy dokončení, včetně kontextových informací, člena oboru názvů a dokončování členů typu
• Linting – V souborech Q# nakonfigurujete lintování pro jednotlivé projekty v souboru manifestu. Další informace najdete v tématu Práce s projekty Q#.

Další informace najdete v části Intellisense v dokumentaci k editoru VS Code.

Běžné úkoly

Práce se soubory a projekty Q#

Task	Action	Poznámky
Nový soubor Q#	Vyberte Soubor > Nový textový soubor>. Uložte soubor s příponou .qs.	Pokud nastavíte Files: Default Language = qsharp, nový soubor se automaticky nastaví na formátování 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 .qs souboru nebo .qasm souboru zadejte ukázky a pak ze seznamu možností vyberte ukázkový program.	Na paletě příkazů můžete také vybrat otevřít dětské hřiště QDK a otevřít online složku ukázkových programů Q# a OpenQASM v Průzkumníkovi souborů.

Připojení k Azure Quantum

Task	Action	Poznámky	Alternativní akce uživatele
Připojení k pracovnímu prostoru Azure Quantum	Vyberte ikonu panelu Microsoft Quantum (vlevo dole). V kvantových pracovních prostorech 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 kvantových pracovních prostorů . Připojení pracovních prostorů se uchovávají mezi relacemi VS Code.	Na paletě příkazů vyberte QDK: Připojit se 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í úloh do Azure Quantum pomocí balíčku QDK Python.	N/A

Spouštění programů

Task	Action	Poznámky	Alternativní akce uživatele
Spuštění programu Q# nebo OpenQASM v místním kvantovém simulátoru	V .qs nebo .qasm souboru vyberte v pravém horním rohu ikonu Spustit a zvolte Spustit.	Další informace o kvantovém simulátoru najdete v řídkém kvantovém simulátoru.	Stiskněte Kombinaci kláves Ctrl + F5 nebo zvolte QDK: Spustit soubor a zobrazit histogram nebo QDK: Spustit soubor a zobrazit diagram obvodu na paletě příkazů nebo zvolte možnost Spustit kód nad operací vstupního bodu.
Odlaď program	V programu Q# nebo OpenQASM vyberte ikonu Spustit v pravém horním rohu a zvolte Spustit ladění.	Další informace o ladicím programu Q# ve VS Code najdete v tématu Ladění a testování kvantového kódu.	Stiskněte F5 nebo v nabídce nad operací startovního bodu zvolte lupu kódu Ladění.
Zobrazit poskytovatele a cíle ve svých pracovních prostorech	Vyberte ikonu panelu Microsoft Quantum (vlevo dole). V kvantových pracovních prostorech rozbalte pracovní prostor a potom rozbalte zprostředkovatele , abyste viděli dostupné zprostředkovatele v pracovním prostoru. Rozbalte jednotlivého poskytovatele a zobrazte dostupné cíle.	Najeďte myší na název cíle, abyste zobrazili jeho stav a čas fronty před odesláním úlohy.	N/A
Odeslání úlohy do Azure Quantum	V programu Q# nebo OpenQASM zvolte pracovní prostor, poskytovatele a cíl. Pokud chcete odeslat aktuální program, vyberte šipku vedle cíle.	Další informace najdete v tématu Odesílání úloh do Azure Quantum s rozšířením QDK pro VS Code.	N/A
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é od nejnovějších po nejstarší.	N/A