Naslaginformatie: Azure Quantum Development Kit-extensie voor Visual Studio Code

De Azure Quantum Development Kit (QDK) maakt gebruik van alle standaardfunctionaliteit van Visual Studio (VS) Code, samen met Q#-specifieke functies bij het werken met .qs-bestanden. Dit artikel is een referentiehandleiding voor alle Q#-gerelateerde opdrachten en functies, met koppelingen naar aanvullende inhoud indien nodig. Raadpleeg de DOCUMENTATIE van VS Code voor algemene RICHTLIJNEN voor VS Code.

Tip

De meeste Q#-gerelateerde opdrachten zijn toegankelijk via het > weergeven. In een .qs-bestand selecteert u Ctrl-Shift-P (Cmd-Shift-P in macOS) en voert u Q# in om een gefilterde lijst met opdrachten weer te geven.

Zie Sneltoetsen voor macOS voor alle macOS-sneltoetsen.

Opdracht

De meeste Q#-gerelateerde opdrachten zijn toegankelijk via het > weergeven. Selecteer Ctrl-Shift-P en voer Q# in om een gefilterde lijst met opdrachten weer te geven. Sommige opdrachten zijn alleen beschikbaar wanneer een .qs-bestand actief is.

Tip

U kunt aangepaste sneltoetsen maken voor elke VS Code-opdracht met behulp van sneltoetsen of Ctrl+K+S. Zie Sleutelbindingen voor VS Code voor meer informatie.

Opdracht	Actie	Opmerkingen	Alternatieve gebruikersactie
Q#: Q#-project maken	Hiermee maakt u een Q#-project in de actieve map, waaronder: * een qsharp.json manifestbestand * een src-submap met een standaardbestand main.qs.	Zie Werken met Q#-projecten voor meer informatie over Q#-projecten.	Klik in Bestandenverkenner met de rechtermuisknop op de doelmap en selecteer Q#-project maken.
Q#: Een Azure Quantum-notebook maken	Hiermee opent u een Jupyter Notebook met een Q# + Python-programma en verzendt u een taak naar Azure Quantum.	Zie Werken met Azure Quantum-notebooks voor meer informatie over Azure Quantum-notebooks.	N.v.t.
Q#: Verbinding maken met een Azure Quantum-werkruimte	Maak verbinding met een Azure Quantum-werkruimte met behulp van uw Azure-account of een verbindingsreeks. Zodra u bent geverifieerd, wordt uw werkruimte weergegeven in Bestandenverkenner in Quantum-werkruimten.	Zie Verbinding maken met uw Azure Quantum-werkruimte voor meer informatie over Azure Quantum-verbindingen.	Beweeg in Bestandenverkenner de muisaanwijzer over Quantum-werkruimten en selecteer het pictogram +.
Q#: Q#-speeltuin openen	Hiermee opent u een onlinemap met Q#-voorbeeldprogramma's in Bestandenverkenner. U kunt de programma's bewerken en uitvoeren in de lokale kwantumsimulator, en ook onderbrekingspunten instellen en de code doorlopen met het ingebouwde foutopsporingsprogramma.	Zie het README-bestand in de voorbeeldmap voor meer informatie.	N.v.t.
Q#: Azure Quantum-werkruimten vernieuwen	Hiermee worden de meest recente wijzigingen van uw verbonden kwantumwerkruimten gesynchroniseerd.	Als er een verbindingsprobleem is, wordt er een waarschuwingspictogram weergegeven naast de naam van de werkruimte.	Beweeg in Bestandenverkenner de muisaanwijzer over Quantum-werkruimten en selecteer het vernieuwingspictogram.
Explorer: Focus op de weergave Kwantumwerkruimten	Hiermee opent u Bestandenverkenner en richt u zich op uw verbonden kwantumwerkruimten, indien geconfigureerd. Als er geen werkruimten zijn geconfigureerd, wordt u gevraagd een bestaande werkruimte toe te voegen.	Zie Verbinding maken met uw Azure Quantum-werkruimte voor meer informatie over Azure Quantum-verbindingen.	N.v.t.

De volgende opdrachten zijn beschikbaar wanneer een .qs-bestand actief is.

Opdracht	Actie	Opmerkingen	Alternatieve gebruikersactie
Q#: Het Azure Quantum QIR-doelprofiel instellen	Hiermee stelt u de QIR of kwantum-tussenliggende weergave, het doelprofiel voor uw Q#-programma's in.	Zie Doelprofielen voor meer informatie over doelprofielen.	Het huidige doelprofiel wordt weergegeven op de onderste werkbalk. Selecteer het doelprofiel op de werkbalk om de vervolgkeuzelijst voor selectie te openen.
Q#: Circuit weergeven	Geeft een circuitdiagram weer voor het Q#-programma voordat het wordt uitgevoerd.	Zie Kwantumcircuitdiagrammen visualiseren voor meer informatie.	Selecteer het codelensoptiecircuit in het menu naast de invoerpuntbewerking of boven elke door de gebruiker gedefinieerde bewerking in het programma.
Q#: Bestand uitvoeren en histogram weergeven	Hiermee wordt het huidige Q#-programma uitgevoerd en wordt een histogram van de resultaten weergegeven in het rechterdeelvenster.	Als u de sorteer- en filteropties voor de histogramweergave wilt openen, selecteert u het filterpictogram in het deelvenster histogram.	Selecteer het codelensoptie Histogram in het menu naast de invoerpuntbewerking.
Q#: QIR ophalen voor het huidige Q#-programma	Hiermee opent u de QIR-bron voor de huidige Q#-code in een nieuw bewerkingsvenster. Uw programma moet het doelprofiel basis- of adaptieve RI gebruiken om de QIR-bron te exporteren.	Zie voor meer informatie over QIR de tussenliggende weergave van Quantum en het Q# -ontwikkelaarsblog.	N.v.t.
Fouten opsporen: Fouten opsporen in Q#-bestand	Hiermee opent u het huidige Q#-programma in het foutopsporingsprogramma.	Zie Foutopsporing en het testen van uw kwantumcode voor meer informatie.	* Selecteer F5 * Selecteer de codelensoptie Foutopsporing in het menu naast de invoerpuntbewerking. * Selecteer het pictogram Uitvoeren in de rechterbovenhoek en selecteer Q#-bestand voor foutopsporing.
Fouten opsporen: Q#-bestand uitvoeren	Hiermee wordt het huidige Q#-programma uitgevoerd in de standaard kwantumsimulator.	Zie Aan de slag met Q#-programma's voor meer informatie.	* Ctrl+F5 selecteren * Selecteer de codelensoptie Uitvoeren in het menu naast de invoerpuntbewerking. * Selecteer het pictogram Uitvoeren in de rechterbovenhoek en selecteer Q#-bestand uitvoeren.
Q#: Resourceramingen berekenen	Roept de ingebouwde versie van de resource-estimator aan.	Zie Inleiding tot de Azure Quantum Resource Estimator voor meer informatie.	N.v.t.
Q#: Help	Een kort overzicht van de QDK-extensie in VS Code.	Raadpleeg de Documentatie van Azure Quantum voor volledige documentatie over Azure Quantum.	N.v.t.
Q#: Bestand uitvoeren en circuitdiagram weergeven	Hiermee wordt het huidige Q#-programma uitgevoerd en wordt een circuit van het programma met uitvoer weergegeven.	Zie Kwantumcircuitdiagrammen visualiseren voor meer informatie.	N.v.t.
Q#: API-documentatie weergeven	Hiermee opent u de API-documentatie in een nieuw deelvenster. Zoek in dit deelvenster met Ctrl-F.	Zie de Naslaginformatie over de Azure Quantum-API voor meer informatie.	N.v.t.

Terminals

Q#-programma's maken gebruik van twee terminalvensters in VS Code:

Terminal	Actie
Foutopsporingsconsole	Uitvoer uitvoeren of foutopsporingsuitvoer weergeven
Problemen	Geeft precompilatiefoutcontroles weer

Q#-code bewerken

De meeste algemene functies voor het bewerken van code in VS Code zijn beschikbaar bij het werken met Q#-programma's. Zie Intellisense in de VS Code-documentatie voor meer informatie.

• Controle van vooraf samengestelde fouten
• Ga-naar-definitie
• Verwijzingen
• Functiehandtekeningen
• Parameterinformatie
• Voltooiingssuggesties, waaronder contextbewust, lid van de naamruimte en voltooiing van het type lid.
• Linting: in Q#-bestanden configureert u linting per project in het manifestbestand. Zie Werken met Q#-projecten voor meer informatie.

Algemene taken

Werken met Q#-bestanden en -projecten

Opdracht	Actie	Opmerkingen
Nieuw Q#-bestand	Selecteer Bestand > nieuw bestand > Tekstbestand. Sla het bestand op met de extensie .qs.	Als u dit instelt Files: Default Language = qsharp, wordt automatisch een nieuw bestand ingesteld op Q#-opmaak.
Een Q#-project maken	Selecteer in een geopende map in Bestandenverkenner Q#-project maken in het opdrachtenpalet of klik met de rechtermuisknop op de map in Bestandenverkenner en selecteer Q#-project maken.	Zie Werken met Q#-projecten voor meer informatie over Q#-projecten.
Voorbeeldbestanden	Voer in een leeg QS-bestand voorbeelden in en selecteer vervolgens een voorbeeldprogramma in de lijst.	U kunt ook Q#-speeltuin openen in het opdrachtpalet selecteren om een onlinemap met Q#-voorbeeldprogramma's te openen in Bestandenverkenner.

Verbinding maken met Azure Quantum

Opdracht	Actie	Opmerkingen	Alternatieve gebruikersactie
Verbinding maken met een Azure Quantum-werkruimte	Vouw in Bestandenverkenner Quantum-werkruimten uit en selecteer Een bestaande werkruimte toevoegen. Volg de aanwijzingen om een abonnement en werkruimte te selecteren.	* U kunt verbinding maken met meerdere werkruimten. Selecteer + naast Quantum-werkruimten om verbinding te maken met een andere werkruimte. Werkruimteverbindingen blijven behouden tussen uw VS Code-sessies. * Als u een werkruimteverbinding wilt verwijderen, klikt u met de rechtermuisknop op de werkruimte en selecteert u Werkruimteverbinding verwijderen.	Selecteer Verbinding maken met een Azure Quantum-werkruimte in het opdrachtenpalet.
Programmatisch verbinding maken met een Python-programma	Klik met de rechtermuisknop op een bestaande werkruimteverbinding en selecteer Python-code kopiëren om verbinding te maken met de werkruimte. Plak de resulterende code in uw Python-programma.	Zie Python met Q#-taken verzenden naar Azure Quantum voor meer informatie.	N.v.t.

Programma's uitvoeren

Opdracht	Actie	Opmerkingen	Alternatieve gebruikersactie
Een Q#-programma uitvoeren in de lokale kwantumsimulator	Selecteer in een Q#-programma het pictogram Uitvoeren in de rechterbovenhoek en selecteer Q#-bestand uitvoeren.	Zie de kwantumsimulator Sparse voor meer informatie over de kwantumsimulator.	* Ctrl-F5 selecteren * Selecteer in het opdrachtenpalet Q#: Bestand uitvoeren en histogram of Q#: Bestand uitvoeren en circuitdiagram weergeven * Selecteer de codelensoptie Uitvoeren in het menu naast de invoerpuntbewerking.
Fouten opsporen in een programma	Selecteer in een Q#-programma het pictogram Uitvoeren in de rechterbovenhoek en selecteer Q#-bestand debug.	Zie Foutopsporing en het testen van uw kwantumcode voor meer informatie over het Q#-foutopsporingsprogramma in VS Code.	* Selecteer F5 * Selecteer de codelensoptie Foutopsporing in het menu naast de invoerpuntbewerking.
Providers en doelen in uw werkruimten weergeven	In Bestandenverkenner selecteert u Quantum-werkruimten, vouwt u de werkruimte uit en vouwt u Providers vervolgens uit om de beschikbare providers in de werkruimte weer te geven. Vouw een afzonderlijke provider uit om de beschikbare doelen weer te geven.	Opmerking: beweeg de muisaanwijzer over een doelnaam om de status en wachtrijtijd weer te geven voordat u een taak verzendt.	N.v.t.
Een taak verzenden naar Azure Quantum	Selecteer in een Q#-programma een werkruimte, provider en doel. Als u het huidige Q#-programma wilt verzenden, selecteert u de pijl naast het doel.	Zie Q#-taken verzenden naar Azure Quantum voor meer informatie.	N.v.t.
Taakresultaten weergeven	Vouw de werkruimte uit en vouw vervolgens Taken uit. Als u de taakuitvoer van Azure Storage wilt openen, selecteert u het cloudpictogram naast de taaknaam.	Taken worden weergegeven met de meest recente bovenaan.	N.v.t.