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

Das Azure Quantum Development Kit (QDK) verwendet alle Standardfunktionen von Visual Studio (VS) Code zusammen mit Q#-spezifischen Features beim Arbeiten mit QS-Dateien. Dieser Artikel ist ein Referenzhandbuch für alle F#-bezogenen Befehle und Features mit Links zu zusätzlichen Inhalten bei Bedarf. Allgemeine VS Code-Anleitungen finden Sie in der VS Code-Dokumentation.

Tipp

Auf die meisten F#-bezogenen Befehle kann über das Menü "Befehlspalette anzeigen>" zugegriffen werden. Wählen Sie in einer QS-Datei STRG-UMSCHALT-P (Cmd-Shift-P unter macOS) aus, und geben Sie Q# ein, um eine gefilterte Liste von Befehlen anzuzeigen.

Alle macOS-Tastenkombinationen finden Sie unter Tastenkombinationen für macOS.

Befehle

Auf die meisten F#-bezogenen Befehle kann über das Menü "Befehlspalette anzeigen>" zugegriffen werden. Wählen Sie STRG-UMSCHALT-P aus, und geben Sie Q# ein, um eine gefilterte Liste von Befehlen anzuzeigen. Einige Befehle sind nur verfügbar, wenn eine QS-Datei aktiv ist.

Tipp

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

Get-Help	Aktion	Hinweise	Alternative Benutzeraktion
F#: Q#-Projekt erstellen	Erstellt ein Q#-Projekt im aktiven Ordner, einschließlich: * eine qsharp.json Manifestdatei * ein src-Unterordner 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.
F#: Erstellen eines Azure Quantum-Notizbuchs	Öffnet ein Beispiel-Jupyter-Notizbuch, das ein Q# + Python-Programm ausführt und einen Auftrag an Azure Quantum sendet.	Weitere Informationen zu Azure Quantum-Notizbüchern finden Sie unter Arbeiten mit Azure Quantum-Notizbüchern.	N/V
F#: Herstellen einer Verbindung mit einem Azure Quantum-Arbeitsbereich	Stellen Sie eine Verbindung mit einem Azure Quantum-Arbeitsbereich mit Ihrem Azure-Konto oder einem Verbindungszeichenfolge her. Nachdem Sie sich authentifiziert haben, wird Ihr Arbeitsbereich in Explorer in Quantum Workspaces angezeigt.	Weitere Informationen zu Azure Quantum-Verbindungen finden Sie unter Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich.	Zeigen Sie in Explorer auf Quantum-Arbeitsbereiche, und wählen Sie das Symbol "+" aus.
F#: Öffnen des Q#-Playgrounds	Öffnet einen Onlineordner von Q#-Beispielprogrammen in 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/V
F#: 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 in Explorer auf Quantum-Arbeitsbereiche, und wählen Sie das Aktualisierungssymbol aus.
Explorer: Fokus auf Quantum Workspaces View	Öffnet Explorer und konzentriert sich auf Ihre verbundenen Quantenarbeitsbereiche, falls 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/V

Die folgenden Befehle sind verfügbar, wenn eine QS-Datei aktiv ist.

Get-Help	Aktion	Hinweise	Alternative Benutzeraktion
F#: Festlegen des Azure Quantum QIR-Zielprofils	Legt das QIR-Zielprofil für Ihre Q#-Programme fest.	Weitere Informationen zu Zielprofilen finden Sie unter "Zielprofile".	Das aktuelle Zielprofil wird in der unteren Symbolleiste angezeigt. Wählen Sie das Zielprofil auf der Symbolleiste aus, um das Auswahldropdown zu öffnen.
F#: Schaltkreis anzeigen	Zeigt ein Schaltkreisdiagramm für das Q#-Programm an, bevor es ausgeführt wird.	Weitere Informationen finden Sie unter Visualisieren von Quantenschaltungsdiagrammen.	Wählen Sie die Codelinsenoption Circuit aus dem Menü neben dem Einstiegspunktvorgang oder über jedem benutzerdefinierten Vorgang im Programm aus.
F#: Datei ausführen und Histogramm anzeigen	Führt das aktuelle Q#-Programm aus und zeigt ein Histogramm der Ergebnisse im rechten Bereich an.	Um auf 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.
F#: QiR für das aktuelle Q#-Programm abrufen	Öffnet die QIR-Quelle für den aktuellen Q#-Code in einem neuen Bearbeitungsfenster. Ihr Programm muss das Base- oder Adaptive RI-Zielprofil zum Exportieren der QIR-Quelle verwenden.	Weitere Informationen zu QIR finden Sie im Q#-Entwicklerblog zur Quantum-Zwischendarstellung.	N/V
Debug: Debug Q#-Datei	Öffnet das aktuelle Q#-Programm im Debugger.	Weitere Informationen finden Sie unter Debuggen und Testen ihres Quantencodes.	* F5 auswählen * Wählen Sie die Codelinsenoption "Debuggen" aus dem Menü neben dem Einstiegspunktvorgang aus. * Wählen Sie das Symbol "Ausführen" oben rechts aus, und wählen Sie "Q#-Datei debuggen" aus.
Debuggen: Q#-Datei ausführen	Führt das aktuelle Q#-Programm im Standardmäßigen Quantensimulator aus.	Weitere Informationen finden Sie unter "Erste Schritte mit Q#-Programmen".	* Strg+F5 auswählen * Wählen Sie die Codelinsenoption "Ausführen " aus dem Menü neben dem Einstiegspunktvorgang aus. * Wählen Sie das Symbol "Ausführen" oben rechts aus, und wählen Sie " Q#-Datei ausführen" aus.
F#: Berechnen von Ressourcenschätzungen	Ruft die integrierte Version des Ressourcenstimators auf.	Weitere Informationen finden Sie in der Einführung in die Azure Quantum Resource Estimator.	N/V
F#: Hilfe	Eine kurze Übersicht über die QDK-Erweiterung in VS Code.	Vollständige Dokumentation zu Azure Quantum finden Sie in der Azure Quantum-Dokumentation.	N/V
F#: Datei ausführen und Schaltkreisdiagramm anzeigen	Führt das aktuelle Q#-Programm aus und zeigt einen Schaltkreis des Programms mit Ausgaben an.	Weitere Informationen finden Sie unter Visualisieren von Quantenschaltungsdiagrammen.	N/V
F#: API-Dokumentation anzeigen	Öffnet die API-Dokumentation in einem neuen Bereich. Durchsuchen Sie diesen Bereich mit STRG-F.	Weitere Informationen finden Sie in der Azure Quantum API-Referenz.	N/V

Terminals

Q#-Programme verwenden zwei Terminalfenster in VS Code:

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

Bearbeiten von Q#-Code

Die meisten gängigen Codebearbeitungsfeatures in VS Code sind beim Arbeiten mit Q#-Programmen verfügbar. Weitere Informationen finden Sie in der VS Code-Dokumentation unter IntelliSense .

• Vorabkompilierungsfehlerüberprüfung
• Gehe zu Definition
• References
• Funktionssignaturen
• Parameterinformationen
• Fertigstellungsvorschläge
• Linting – In Q#-Dateien konfigurieren Sie das Linting pro Projekt in der Manifestdatei. Weitere Informationen finden Sie unter Arbeiten mit Q#-Projekten.

Häufige Aufgaben

Arbeiten mit Q#-Dateien und -Projekten

Aufgabe	Aktion	Hinweise
Neue Q#-Datei	Wählen Sie "Neue > Datei"-Textdatei >aus. Speichern Sie die Datei mit der Erweiterung QS.	Wenn Sie festlegen Files: Default Language = qsharp, wird automatisch eine neue Datei auf Q#-Formatierung festgelegt.
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 Beispiele ein, und wählen Sie dann ein Beispielprogramm aus der Liste aus.	Sie können auch den Open Q#-Playground in der Befehlspalette auswählen, um einen Onlineordner von Q#-Beispielprogrammen in Explorer zu öffnen.

Herstellen einer Verbindung mit Azure Quantum

Aufgabe	Aktion	Hinweise	Alternative Benutzeraktion
Herstellen einer Verbindung mit einem Azure Quantum-Arbeitsbereich	Erweitern Sie in 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-Arbeitsbereichen aus, um einen anderen Arbeitsbereich zu verbinden. Arbeitsbereichsverbindungen bleiben zwischen Ihren VS-Codesitzungen erhalten. * Wenn Sie eine Arbeitsbereichsverbindung entfernen möchten, klicken Sie mit der rechten Maustaste auf den Arbeitsbereich, und wählen Sie "Arbeitsbereichsverbindung entfernen" aus.	Wählen Sie in der Befehlspalette die Option "Mit einem Azure Quantum-Arbeitsbereich verbinden" 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/V

Ausführen von Programmen

Aufgabe	Aktion	Hinweise	Alternative Benutzeraktion
Ausführen eines Q#-Programms auf dem lokalen Quantensimulator	Wählen Sie in einem Q#-Programm oben rechts das Symbol "Ausführen " und dann "Q#-Datei ausführen" aus.	Weitere Informationen zum Quantensimulator finden Sie im Sparse-Quantensimulator.	* Strg-F5 auswählen * Wählen Sie in der Befehlspalette Q#: Datei ausführen und Histogramm oder Q# anzeigen: Datei ausführen und Schaltkreisdiagramm anzeigen * Wählen Sie die Codelinsenoption "Ausführen " aus dem Menü neben dem Einstiegspunktvorgang aus.
Debuggen eines Programms	Wählen Sie in einem Q#-Programm oben rechts das Symbol "Ausführen " und dann " Q#-Datei debuggen" aus.	Weitere Informationen zum Q#-Debugger in VS Code finden Sie unter Debuggen und Testen des Quantencodes.	* F5 auswählen * Wählen Sie die Codelinsenoption "Debuggen" aus dem Menü neben dem Einstiegspunktvorgang aus.
Anzeigen von Anbietern und Zielen in Ihren Arbeitsbereichen	Wählen Sie in Explorer Quantum-Arbeitsbereiche 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.	Hinweis: Zeigen Sie mit dem Mauszeiger auf einen Zielnamen, um die Status- und Warteschlangenzeit anzuzeigen, bevor Sie einen Auftrag übermitteln.	N/V
Übermitteln eines Auftrags an Azure Quantum	Wählen Sie in einem Q#-Programm einen Arbeitsbereich, einen Anbieter und ein Ziel aus. Um das aktuelle Q#-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/V
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 mit der neuesten listet.	N/V