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 die wichtigsten 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.

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

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".

Commands

Viele der QDK-Befehle beziehen sich auf das Schreiben und Ausführen von Q#- und OpenQASM-Programmen und sind nur verfügbar, wenn eine .qasm-, .qsc- oder .qs-Datei aktiv ist. Andere Befehle sind allgemein verfügbar.

Allgemeine Befehle

Command Action Hinweise Alternative Benutzeraktion
QDK: Erstellen eines Q#-Projekts 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 mit dem QDK-Python-Paket. 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, wählen Sie das Symbol für das Microsoft Quantumpanel (unten links) aus. Weitere Informationen zu Azure Quantum-Verbindungen finden Sie unter Herstellen einer Verbindung mit Ihrem Azure Quantum-Arbeitsbereich. Bewegen Sie den Mauszeiger auf Quantum workspaces 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. Bewegen Sie den Mauszeiger über Quantum Workspaces, und wählen Sie das Symbol zum Aktualisieren aus.
QDK: Erstellen einer Microsoft Quantum Python virtuellen Umgebung Erstellt einen Ordner und installiert eine Python virtuelle Umgebung mit den ausgewählten Paketen. Verfügbar im Desktop VS Code, jedoch nicht im VS-Code für das Web. N/A
QDK: Bloch Kugel Öffnet den Bloch-Kugel-Visualisierer. Weitere Informationen finden Sie unter So verwenden Sie den Bloch-Kugel-Visualizer im QDK. 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
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

Verfügbare Befehle basierend auf dem aktiven Dateityp

Command Programmdateitypen Action Hinweise Alternative Benutzeraktion
QDK: Schaltkreis anzeigen .qs, .qasm 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 .qs, .qasm Führt das aktuelle Programm aus und zeigt ein Histogramm der Ergebnisse in einem neuen Bereich an. Um auf die Sortier- und Filteroptionen zuzugreifen, wählen Sie im Histogrammbereich das Filtersymbol aus. Wählen Sie die CodeLens-Option Histogramm aus dem Menü neben dem Einstiegspunktvorgang aus.
QDK: QIR für das aktuelle QDK-Programm abrufen .qs, .qasm Ö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 im Quantum Intermediate Representation und im QDK-Entwicklerblog. N/A
QDK: Berechnen von Ressourcenschätzungen .qs, .qasm 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 .qs Öffnet eine kurze Übersicht über die QDK-Erweiterung in VS Code. N/A N/A
QDK: Datei ausführen und Schaltkreisdiagramm anzeigen .qs, .qasm 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 .qs Öffnet die API-Dokumentation in einem neuen Bereich. Um diesen Bereich zu durchsuchen, drücken Sie STRG+F. Weitere Informationen finden Sie in der Q#-API-Referenz. N/A
Debuggen: Debuggen starten .qs, .qasm.qsc Öffnet das aktuelle Programm im Debugger. Weitere Informationen finden Sie unter Debuggen und Testen ihres Quantencodes. Drücken Sie F5, wählen Sie die Codeobjektivoption "Debuggen " neben dem Einstiegspunktvorgang aus, oder wählen Sie das Symbol "Ausführen" in der oberen rechten Ecke aus, und wählen Sie dann " Debuggen starten" aus.
QDK: Programm ausführen .qs, .qasm.qsc 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, wählen Sie die CodeLens-Option Ausführen neben der Einstiegspunktoperation aus, oder wählen Sie das Symbol Ausführen oben rechts und dann Ausführen aus.

Panelansichten

Programme in Q# und OpenQASM nutzen die folgenden Ansichten im VS Code-Bereich:

Anzeigen 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 Vervollständigungen sowie Vervollständigungen für Namespace-Member und Typmember.
  • 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

In den folgenden Tabellen werden Befehle für allgemeine Aufgaben aufgeführt, wenn Sie mit der QDK-Erweiterung arbeiten.

Arbeiten mit Q#-Dateien und -Projekten

Aufgabe Action Hinweise
Erstellen einer neuen 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 im Datei-Explorer QDK: Q#-Projekt aus der Befehlspalette erstellen aus, oder klicken Sie im Datei-Explorer mit der rechten Maustaste auf den Ordner, und wählen Sie "Q#-Projekt erstellen" aus. Weitere Informationen zu Q#-Projekten finden Sie unter Arbeiten mit Q#-Projekten.
Erstellen einer Beispieldatei 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 QDK auswählen: Öffnen Sie den QDK-Playground in der Befehlspalette, 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 Wählen Sie das Symbol Microsoft Quantumpanel (unten links) aus. Wählen Sie in Quantum Workspaces"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 VS 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 Aufträgen an Azure Quantum mit dem QDK-Python-Paket. 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 die Option zum Debuggen von CodeLens aus dem Menü oberhalb des Einstiegspunktvorgangs aus.
Anbieter und Ziele in Ihren Arbeitsbereichen anzeigen Wählen Sie das Symbol Microsoft Quantumpanel (unten links) aus. Erweitern Sie aus Quantum Workspaces 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 Aufträgen an Azure Quantum mit der QDK-Erweiterung für VS Code. 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
  • Zuletzt aktualisiert um