Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das Azure Quantum Development Kit (QDK) verwendet alle Standardfunktionen von Visual Studio Code (VS Code) zusammen mit Q#-spezifischen Features, wenn Sie mit .qs Dateien 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.
Tipp
Auf die meisten Befehle aus der QDK-Erweiterung kann über das Menü "Befehlspalette anzeigen>" zugegriffen werden. Öffnen Sie in einer .qs Datei die Befehlspalette, und geben Sie QDK ein, um eine gefilterte Liste von Befehlen anzuzeigen.
Befehle
Die meisten QDK-Befehle beziehen sich auf das Schreiben und Ausführen von Q#-Programmen und sind nur verfügbar, wenn eine .qs Datei 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.
Tipp
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".
| Get-Help | Aktion | 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 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 |
| QDK: 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. | Gehen Sie im Datei-Explorer zu Quantum-Arbeitsbereiche und wählen Sie das Symbol "+" aus. |
| QDK: Open QDK Playground | Ö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 |
| 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 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 |
|---|---|---|---|
| QDK: 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. |
| QDK: Datei ausführen und Histogramm anzeigen | Führt das aktuelle Q#-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#-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 Q#-Entwicklerblog zur Quantum-Zwischendarstellung. | N/V |
| QDK: 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 |
| QDK: 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 |
| QDK: 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 |
| QDK: Hinzufügen der Copilot-Anweisungendatei für Q# und OpenQASM | Öffnet eine Eingabeaufforderung, die Ihnen die Möglichkeit gibt, Copilot-Anweisungen hinzuzufügen, um Q#- und OpenQASM-Code zu schreiben und auszuführen. | Weitere Informationen finden Sie unter Einrichten des Agentmodus im VS Code für das Quantum Development Kit. | N/V |
| 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 Azure Quantum API-Referenz. | N/V |
| 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/V |
| Debuggen: Debuggen starten | Öffnet das aktuelle Q#-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 Q#-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
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. |
Q#-Code bearbeiten
Die meisten gängigen Codebearbeitungsfeatures in VS Code sind auch verfügbar, wenn Sie mit Q#-Programmen arbeiten:
- Vorabkompilierungsfehlerüberprüfung
- Gehe zu Definition
- References
- 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 .
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 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 Beispiele 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#-Beispielprogrammen im Datei-Explorer zu öffnen. |
Herstellen einer Verbindung mit Azure Quantum
| Aufgabe | Aktion | 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 VS-Codesitzungen 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/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 "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#-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. |
| Anzeigen von Anbietern und Zielen in Ihren Arbeitsbereichen | 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/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 von der neuesten bis zur ältesten listet. | N/V |