Referenz: Microsoft Quantum Development Kit-Erweiterung für Visual Studio Code

Die Microsoft Quantum Development Kit (QDK) verwendet die Standardfunktionalität von Visual Studio Code (VS Code) zusammen mit sprachspezifischen Features, wenn Sie mit dateien .qs oder .qasm arbeiten. In diesem Referenzhandbuch werden alle QDK-Befehle beschrieben, auf die Sie in der VS-Codebefehlspalette zugreifen können, sowie weitere Features und Links zu zusätzlichen Inhalten. Allgemeine VS Code-Anleitungen finden Sie in der VS Code-Dokumentation.

Tip

Auf die meisten Befehle aus der QDK-Erweiterung kann über das Menü "Befehlspalette anzeigen>" zugegriffen werden. Öffnen Sie in einer .qs oder .qasm einer Datei die Befehlspalette, und geben Sie QDK ein, um eine gefilterte Liste von Befehlen anzuzeigen.

Commands

Die meisten QDK-Befehle beziehen sich auf das Schreiben und Ausführen von Q#- und OpenQASM-Programmen und sind nur verfügbar, wenn eine .qs Datei .qasm aktiv ist. Andere Befehle funktionieren im Hintergrund und sind in der Befehlspalette nicht verfügbar.

In der folgenden Tabelle werden die Befehle aus der QDK-Erweiterung beschrieben, die in der Befehlspalette angezeigt werden.

Tip

Sie können benutzerdefinierte Tastenkombinationen für VS-Code-Befehle mithilfe von Tastenkombinationen oder STRG+K+S erstellen. Weitere Informationen finden Sie unter "Key Bindings for VS Code".

Command	Action	Hinweise	Alternative Benutzeraktion
QDK: Q#-Projekt erstellen	Erstellt ein Q#-Projekt im aktiven Ordner, einschließlich einer qsharp.json Manifestdatei und eines src Unterordners mit einer Standarddatei main.qs .	Weitere Informationen zu Q#-Projekten finden Sie unter Arbeiten mit Q#-Projekten.	Klicken Sie in Explorer mit der rechten Maustaste auf den Zielordner, und wählen Sie "Q#-Projekt erstellen" aus.
QDK: Erstellen eines Microsoft Quantum-Notizbuchs	Öffnet ein Beispiel-Jupyter-Notizbuch, das ein Q# + Python-Programm ausführt und einen Auftrag an Azure Quantum sendet.	Weitere Informationen zum QDK in Jupyter Notebook finden Sie unter Übermitteln von Aufträgen an Azure Quantum aus Jupyter Notebook.	N/A
QDK: Herstellen einer Verbindung mit einem Azure Quantum-Arbeitsbereich	Stellen Sie eine Verbindung mit einem Azure Quantum-Arbeitsbereich mit Ihrem Azure-Konto oder einer Verbindungszeichenkette her. Nachdem Sie sich authentifiziert haben, wird Ihr Arbeitsbereich in Datei-Explorer in Quantum Workspaces angezeigt.	Weitere Informationen zu Azure Quantum-Verbindungen finden Sie unter Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich.	Gehen Sie im Datei-Explorer zu Quantum-Arbeitsbereiche und wählen Sie das Symbol "+" aus.
QDK: Open QDK Playground	Öffnet einen Onlineordner von Q#- und OpenQASM-Beispielprogrammen im Datei-Explorer. Sie können die Programme im lokalen Quantensimulator bearbeiten und ausführen und auch Haltepunkte festlegen und den Code mit dem integrierten Debugger durchlaufen.	Weitere Informationen finden Sie in der README-Datei im Beispielordner.	N/A
QDK: Aktualisieren von Azure Quantum-Arbeitsbereichen	Synchronisiert die neuesten Änderungen aus Ihren verbundenen Quantenarbeitsbereichen.	Wenn ein Verbindungsproblem auftritt, wird neben dem Arbeitsbereichsnamen ein Benachrichtigungssymbol angezeigt.	Zeigen Sie im Datei-Explorer auf Quantum Workspaces , und wählen Sie das Aktualisierungssymbol aus.
Explorer: Fokus auf Quantum Workspaces View	Öffnet den Datei-Explorer und fokussiert auf die verbundenen Quantenarbeitsbereiche, sofern konfiguriert. Wenn keine Arbeitsbereiche konfiguriert sind, werden Sie aufgefordert, einen vorhandenen Arbeitsbereich hinzuzufügen.	Weitere Informationen zu Azure Quantum-Verbindungen finden Sie unter Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich.	N/A

Die folgenden Befehle sind verfügbar, wenn eine .qs- oder .qasm-Datei aktiv ist.

Command	Action	Hinweise	Alternative Benutzeraktion
QDK: Schaltkreis anzeigen	Zeigt ein Schaltkreisdiagramm für das Programm an, bevor es ausgeführt wird.	Weitere Informationen finden Sie unter Visualisieren von Quantenschaltungsdiagrammen.	Wählen Sie die CodeLens-Option Circuit aus dem Menü neben der Einstiegspunktoperation oder über jeder benutzerdefinierten Operation im Programm aus.
QDK: Datei ausführen und Histogramm anzeigen	Führt das aktuelle Programm aus und zeigt ein Histogramm der Ergebnisse in einem neuen Bereich an.	Um auf die Sortier- und Filteroptionen für die Histogrammanzeige zuzugreifen, wählen Sie im Histogrammbereich das Filtersymbol aus.	Wählen Sie die Codelinsenoption Histogramm aus dem Menü neben dem Einstiegspunktvorgang aus.
QDK: QIR für das aktuelle QDK-Programm abrufen	Öffnet die QIR-Quelle für den aktuellen Q#- oder OpenQASM-Code in einem neuen Bearbeitungsfenster. Ihr Programm muss das Base-, Adaptive RI- oder Adaptive RIF-Zielprofil zum Exportieren der QIR-Quelle verwenden.	Weitere Informationen zu QIR finden Sie unter Quantum Intermediate Representation und im QDK-Entwicklerblog.	N/A
QDK: Berechnen von Ressourcenschätzungen	Ruft die integrierte Version der Ressourcenschätzung auf.	Weitere Informationen finden Sie in der Einführung in die Microsoft Quantum-Ressourcenschätzung.	N/A
QDK: Hilfe	Eine kurze Übersicht über die QDK-Erweiterung in VS Code.	Vollständige Dokumentation zu Microsoft Quantum finden Sie in der Microsoft Quantum-Dokumentation.	N/A
QDK: Datei ausführen und Schaltkreisdiagramm anzeigen	Führt das aktuelle Programm aus und zeigt einen Schaltkreis des Programms mit Ausgängen an.	Weitere Informationen finden Sie unter Visualisieren von Quantenschaltungsdiagrammen.	N/A
QDK: API-Dokumentation anzeigen	Öffnet die API-Dokumentation in einem neuen Bereich. Um diesen Bereich zu durchsuchen, drücken Sie STRG+F.	Weitere Informationen finden Sie in der Microsoft Quantum API-Referenz.	N/A
QDK: Änderungsprotokoll anzeigen	Öffnet einen Änderungsprotokoll auf einer neuen Registerkarte, auf der die QDK-Updates für die aktuellen und alle vorherigen Versionen angezeigt werden.	Der Änderungsprotokoll ist auch im Open-Source-QDK-GitHub-Repository verfügbar.	N/A
Debuggen: Debuggen starten	Öffnet das aktuelle Programm im Debugger.	Weitere Informationen finden Sie unter Debuggen und Testen ihres Quantencodes.	Drücken Sie F5, oder wählen Sie die Codeobjektivoption "Debuggen" aus dem Menü neben dem Einstiegspunktvorgang aus, oder wählen Sie oben rechts das Symbol "Ausführen" aus, und wählen Sie "Debuggen starten" aus.
Debug: Ausführen	Führt das aktuelle Programm im Standardmäßigen Quantensimulator aus.	Weitere Informationen finden Sie unter "Erste Schritte mit Q#-Programmen".	Drücken Sie STRG + F5, oder wählen Sie die CodeLens-Option Ausführen aus dem Menü neben dem Einstiegspunkt aus, oder wählen Sie das Symbol Ausführen oben rechts und dann Ausführen.

Terminals/Anschlüsse

Q#- und OpenQASM-Programme nutzen zwei Terminalfenster in VS Code:

Terminal	Action
Debugkonsole	Zeigt die Ausführungsausgabe oder Debugausgabe an.
Probleme	Zeigt Fehlerüberprüfungen vor der Kompilierung an.

Bearbeiten von Q#- und OpenQASM-Code

Die meisten gängigen Codebearbeitungsfeatures in VS Code sind auch verfügbar, wenn Sie mit Q#- und OpenQASM-Programmen arbeiten:

• Vorabkompilierungsfehlerüberprüfung
• Gehe zu Definition
• Referenzen
• Funktionssignaturen
• Parameterinformationen
• Vervollständigungsvorschläge, einschließlich kontextbezogener, Namespace- und Typmember-Vervollständigungen.
• Linting – In Q#-Dateien konfigurieren Sie das Linting pro Projekt in der Manifestdatei. Weitere Informationen finden Sie unter Arbeiten mit Q#-Projekten.

Weitere Informationen finden Sie in der VS Code-Dokumentation unter IntelliSense .

Allgemeine Aufgaben

Arbeiten mit Q#-Dateien und -Projekten

Aufgabe	Action	Hinweise
Neue Q#-Datei	Wählen Sie Datei > Neue Datei > Textdatei aus. Speichern Sie die Datei mit einer .qs Erweiterung.	Wenn Sie festlegen Files: Default Language = qsharp, wird für eine neue Datei automatisch die Q#-Formatierung verwendet.
Erstellen eines Q#-Projekts	Wählen Sie in einem geöffneten Ordner in Explorer "Q#-Projekt erstellen" in der Befehlspalette aus, oder klicken Sie mit der rechten Maustaste auf den Ordner in Explorer, und wählen Sie "Q#-Projekt erstellen" aus.	Weitere Informationen zu Q#-Projekten finden Sie unter Arbeiten mit Q#-Projekten.
Beispieldateien	Geben Sie in einer leeren .qs Datei .qasm ein, und wählen Sie dann ein Beispielprogramm aus der Liste der Optionen aus.	Sie können auch den Open QDK-Playground in der Befehlspalette auswählen, um einen Onlineordner von Q#- und OpenQASM-Beispielprogrammen im Datei-Explorer zu öffnen.

Herstellen einer Verbindung mit Azure Quantum

Aufgabe	Action	Hinweise	Alternative Benutzeraktion
Herstellen einer Verbindung mit einem Azure Quantum-Arbeitsbereich	Erweitern Sie im Datei-Explorer Quantum-Arbeitsbereiche , und wählen Sie "Vorhandenen Arbeitsbereich hinzufügen" aus. Folgen Sie den Anweisungen, um ein Abonnement und einen Arbeitsbereich auszuwählen.	Sie können eine Verbindung mit mehreren Arbeitsbereichen herstellen. Wählen Sie + neben Quantum Workspaces aus, um einen anderen Arbeitsbereich zu verbinden. Arbeitsbereichsverbindungen bleiben zwischen Ihren Visual Studio Code-Sitzungen erhalten.	Wählen Sie in der Befehlspalette QDK: Verbinden mit einem Azure Quantum-Arbeitsbereich aus.
Programmgesteuertes Verbinden mit einem Python-Programm	Klicken Sie mit der rechten Maustaste auf eine vorhandene Arbeitsbereichsverbindung, und wählen Sie "Python-Code kopieren" aus, um eine Verbindung mit dem Arbeitsbereich herzustellen. Fügen Sie den resultierenden Code in Ihr Python-Programm ein.	Weitere Informationen finden Sie unter Übermitteln von Python mit Q#-Aufträgen an Azure Quantum.	N/A

Ausführen von Programmen

Aufgabe	Action	Hinweise	Alternative Benutzeraktion
Ausführen eines Q#- oder OpenQASM-Programms auf dem lokalen Quantensimulator	Wählen Sie in einer .qs oder .qasm einer Datei das Symbol " Ausführen " oben rechts aus, und wählen Sie "Ausführen" aus.	Weitere Informationen zum Quantensimulator finden Sie im Sparse-Quantensimulator.	Drücken Sie STRG+F5, oder wählen Sie entweder QDK: Datei ausführen und Histogramm anzeigen oder QDK: Datei ausführen und Schaltkreisdiagramm anzeigen in der Befehlspalette, oder wählen Sie die Option Code-Lens ausführen oberhalb der Einstiegspunktoperation aus.
Debuggen eines Programms	Wählen Sie in einem Q#- oder OpenQASM-Programm oben rechts das Symbol " Ausführen " und dann "Debuggen starten" aus.	Weitere Informationen zum Q#-Debugger in VS Code finden Sie unter Debuggen und Testen des Quantencodes.	Drücken Sie F5, oder wählen Sie das Codedebuggingobjektiv aus dem Menü oberhalb des Einstiegspunktvorgangs aus.
Anbieter und Ziele in Ihren Arbeitsbereichen anzeigen	Wählen Sie im Datei-Explorer Quantum Workspaces aus, erweitern Sie den Arbeitsbereich, und erweitern Sie dann Anbieter , um die verfügbaren Anbieter im Arbeitsbereich anzuzeigen. Erweitern Sie einen einzelnen Anbieter, um die verfügbaren Ziele anzuzeigen.	Fahren Sie mit der Maus über einen Zielnamen, um den Status und die Warteschlangenzeit anzuzeigen, bevor Sie einen Auftrag absenden.	N/A
Übermitteln eines Auftrags an Azure Quantum	Wählen Sie in einem Q#- oder OpenQASM-Programm einen Arbeitsbereich, einen Anbieter und ein Ziel aus. Um das aktuelle Programm zu übermitteln, wählen Sie den Pfeil neben dem Ziel aus.	Weitere Informationen finden Sie unter Übermitteln von Q#-Aufträgen an Azure Quantum.	N/A
Anzeigen von Auftragsergebnissen	Erweitern Sie den Arbeitsbereich, und erweitern Sie dann Aufträge. Um die Auftragsausgabe aus Azure Storage zu öffnen, wählen Sie das Cloudsymbol neben dem Auftragsnamen aus.	Aufträge werden von der neuesten bis zur ältesten listet.	N/A