Delen via

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

De Azure Quantum Development Kit (QDK) maakt gebruik van alle standaardfunctionaliteit van Visual Studio Code (VS Code), samen met Q#-specifieke functies wanneer u met .qs bestanden werkt. In deze naslaggids worden alle QDK-opdrachten beschreven die u kunt openen in het OPDRACHTENpalet van VS Code, samen met andere functies en koppelingen naar aanvullende inhoud. Raadpleeg de DOCUMENTATIE van VS Code voor algemene RICHTLIJNEN voor VS Code.

Tip

De meeste opdrachten uit de QDK-extensie zijn toegankelijk via het menu Opdrachtenpalet weergeven>. Open in een .qs bestand het opdrachtenpalet en voer QDK in: om een gefilterde lijst met opdrachten weer te geven.

Opdrachten

De meeste QDK-opdrachten zijn gerelateerd aan het schrijven en uitvoeren van Q#-programma's en zijn alleen beschikbaar wanneer een .qs bestand actief is. Andere opdrachten werken op de achtergrond en zijn niet toegankelijk in het opdrachtenpalet.

In de volgende tabel worden de opdrachten van de QDK-extensie beschreven die worden weergegeven in het opdrachtenpalet.

Tip

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

Opdracht Actie Opmerkingen Alternatieve gebruikersactie
QDK: Q#-project maken Hiermee maakt u een Q#-project in de actieve map, inclusief een qsharp.json manifestbestand en 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 aanmaken.
QDK: 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.
QDK: 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 Verkenner de muisaanwijzer over Quantum-werkruimten en selecteer het pictogram +.
QDK: KDK-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.
QDK: 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 Verkenner de muisaanwijzer over Quantum-werkruimten en selecteer het vernieuwingspictogram .
Explorer: Focus op Kwantumwerkruimteweergave 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
QDK: Circuit weergeven Geeft een circuitdiagram weer voor het Q#-programma voordat het wordt uitgevoerd. Zie Kwantumcircuitdiagrammen visualiseren voor meer informatie. Selecteer de codelensoptie Circuit in het menu naast de bewerking vanaf het invoerpunt of boven de door de gebruiker gedefinieerde bewerkingen in het programma.
QDK: Bestand uitvoeren en histogram weergeven Hiermee wordt het huidige Q#-programma uitgevoerd en wordt een histogram van de resultaten weergegeven in een nieuw deelvenster. Als u de sorteer- en filteropties voor de histogramweergave wilt openen, selecteert u het filterpictogram in het deelvenster histogram. Selecteer de code lens-optie Histogram in het menu naast de operatie van het invoerpunt.
QDK: QIR ophalen voor het huidige QDK programma Hiermee opent u de QIR-bron voor de huidige Q#-code in een nieuw bewerkingsvenster. Uw programma moet gebruikmaken van het doelprofiel Base, Adaptive RI of Adaptive RIF om de QIR-bron te exporteren. Zie voor meer informatie over QIR de tussenliggende weergave van Quantum en het Q# -ontwikkelaarsblog. N.v.t.
QDK: Resourceschattingen berekenen Roept de ingebouwde versie van de resource-estimator aan. Zie Inleiding tot de Azure Quantum Resource Estimator voor meer informatie. N.v.t.
QDK: 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.
QDK: 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.
QDK: Copilot-instructiesbestand toevoegen voor Q# en OpenQASM Hiermee opent u een prompt waarmee u Copilot-instructies kunt toevoegen om Q# anf OpenQASM-code te schrijven en uit te voeren. Zie Agentmodus instellen in VS Code voor de Quantum Development Kit voor meer informatie. N.v.t.
QDK: API-documentatie weergeven Hiermee opent u de API-documentatie in een nieuw deelvenster. Druk op Ctrl+F om in dit deelvenster te zoeken. Zie voor meer informatie de Azure Quantum API-referentie. N.v.t.
QDK: Changelog weergeven Hiermee opent u een wijzigingslogboek op een nieuw tabblad met de QDK-updates voor de huidige en alle vorige releaseversies. Het wijzigingenlogboek is ook beschikbaar in de opensource QDK GitHub-opslagplaats. N.v.t.
Foutopsporing: Foutopsporing starten Hiermee opent u het huidige Q#-programma in het foutopsporingsprogramma. Zie Foutopsporing en het testen van uw kwantumcode voor meer informatie. Druk op F5 of selecteer de codelensoptie Fouten opsporen in het menu naast de invoerpuntbewerking of selecteer het pictogram Uitvoeren in de rechterbovenhoek en kies Foutopsporing starten.
Fouten opsporen: uitvoeren Hiermee wordt het huidige Q#-programma uitgevoerd in de standaard kwantumsimulator. Zie Aan de slag met Q#-programma's voor meer informatie. Druk op Ctrl+F5 of selecteer de code lens optie Uitvoeren in het menu naast de bewerking van het invoerpunt, of selecteer het pictogram Uitvoeren in de rechterbovenhoek en kies Uitvoeren.

Terminals

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

Terminal Actie
Debugconsole Uitvoer of foutopsporingsuitvoer weergeven
Problemen Geeft precompilatiefoutcontrole weer

Q#-code bewerken

De meeste algemene functies voor het bewerken van code in VS Code zijn ook beschikbaar wanneer u met Q#-programma's werkt:

  • Foutcontrole bij precompilatie
  • Ga naar definitie
  • Verwijzingen
  • Functiesignaturen
  • Parameterinformatie
  • Voltooiingssuggesties, waaronder contextbewuste, naamruimtelid- en typelid-voltooiingen.
  • Linting: in Q#-bestanden configureert u linting per project in het manifestbestand. Zie Werken met Q#-projecten voor meer informatie.

Zie Intellisense in de VS Code-documentatie 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 een .qs extensie. Als u instelt Files: Default Language = qsharp, wordt automatisch een nieuw bestand standaard 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 met opties. U kunt ook Open QDK playground selecteren in de Command Palette om een online map met voorbeeldprogramma’s in Q# te openen in de File Explorer.

Verbinding maken met Azure Quantum

Opdracht Actie Opmerkingen Alternatieve gebruikersactie
Verbinding maken met een Azure Quantum-werkruimte Vouw in Verkenner Kwantumwerkruimten 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. Selecteer in het opdrachtenpalet QDK: Verbinding maken met een Azure Quantum-werkruimte.
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 Uitvoeren. Zie de kwantumsimulator Sparse voor meer informatie over de kwantumsimulator. Druk op Ctrl + F5, of kies in het opdrachtpalet ofwel QDK: Bestand uitvoeren en histogram weergeven of QDK: Bestand uitvoeren en circuitdiagram weergeven, of kies de optie Uitvoeren in de codelens boven de invoerpuntbewerking.
Fouten opsporen in een programma Selecteer in een Q#-programma het pictogram Uitvoeren in de rechterbovenhoek en kies Debugging starten. Zie Foutopsporing en het testen van uw kwantumcode voor meer informatie over het Q#-foutopsporingsprogramma in VS Code. Druk op F5 of kies de Debug-codelens in het menu boven de beginpuntbewerking.
Providers en doelen in uw werkruimten weergeven In Verkenner selecteert u Quantum-werkruimten, vouwt u de werkruimte uit, en vervolgens vouwt u Providers uit om de beschikbare providers in de werkruimte te zien. Vouw een afzonderlijke provider uit om de beschikbare doelen weer te geven. Beweeg de muisaanwijzer over een doelnaam om de status en wachtrijtijd te bekijken 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 opgesomd van nieuw naar oud. N.v.t.
  • Last updated on