Naslaginformatie: Microsoft Quantum Development-kit-extensie voor Visual Studio Code

De Microsoft Quantum Development-kit (QDK) maakt gebruik van de standaardfunctionaliteit van Visual Studio Code (VS Code), samen met taalspecifieke functies wanneer u met .qs of .qasm-bestanden werkt. In deze naslaghandleiding worden de belangrijkste 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.

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

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.

Opdrachten

Veel van de QDK-opdrachten zijn gerelateerd aan het schrijven en uitvoeren van Q#- en OpenQASM-programma's en zijn alleen beschikbaar wanneer een .qs, .qasmof .qsc bestand actief is. Andere opdrachten zijn algemeen beschikbaar.

Algemene opdrachten

Command Action Aantekeningen 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 Microsoft Quantum-notebook maken Hiermee opent u een Jupyter Notebook met een Q# + Python-programma en verzendt u een taak naar Azure Quantum. Zie Taken indienen bij Azure Quantum met het QDK-Python-pakket voor meer informatie over de QDK in Jupyter Notebook. N/A
QDK: Verbinding maken met een Azure Quantum-werkruimte Maak verbinding met een Azure Quantum-werkruimte met behulp van uw Azure-account of een verbindingsreeks. Nadat u bent geverifieerd, selecteert u het pictogram van het Microsoft quantumpaneel (linksonder). Zie Verbinding maken met uw Azure Quantum-werkruimte voor meer informatie over Azure Quantum-verbindingen. Beweeg de muisaanwijzer over Quantum-werkruimten en selecteer het pictogram +.
QDK: KDK-speeltuin openen Hiermee opent u een online map van Q#- en OpenQASM-voorbeeldprogramma's in Windows Verkenner. 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/A
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 de muisaanwijzer over Quantum-werkruimten en selecteer het vernieuwingspictogram .
QDK: een virtuele Microsoft Quantum Python-omgeving maken Hiermee maakt u een map en installeert u een Python virtuele omgeving met de geselecteerde pakketten. Beschikbaar in desktop VS Code, maar niet VS Code voor het web. N/A
QDK: Bloch sphere Opent de Bloch-bolvisualisatie. Zie Bloch-sfeervisualisatie gebruiken in de QDK voor meer informatie. N/A
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/A
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/A

Beschikbare opdrachten op basis van het actieve bestandstype

Command Programmabestandstypen Action Aantekeningen Alternatieve gebruikersactie
QDK: Circuit weergeven .qs, .qasm Geeft een circuitdiagram weer voor het 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 .qs, .qasm Hiermee wordt het huidige programma uitgevoerd en wordt een histogram van de resultaten in een nieuw deelvenster weergegeven. Als u de sorteer- en filteropties 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 .qs, .qasm Hiermee opent u de QIR-bron voor de huidige Q# of OpenQASM-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 QDK-ontwikkelaarsblog. N/A
QDK: Resourceschattingen berekenen .qs, .qasm Roept de ingebouwde versie van de resource-estimator aan. Zie Inleiding tot de Microsoft Quantum-resourceschatter voor meer informatie. N/A
QDK: Help .qs Hiermee opent u een kort overzicht van de QDK-extensie in VS Code. N/A N/A
QDK: Bestand uitvoeren en circuitdiagram weergeven .qs, .qasm Hiermee wordt het huidige programma uitgevoerd en wordt een circuit van het programma met uitvoer weergegeven. Zie Kwantumcircuitdiagrammen visualiseren voor meer informatie. N/A
QDK: API-documentatie weergeven .qs Hiermee opent u de API-documentatie in een nieuw deelvenster. Druk op Ctrl+F om in dit deelvenster te zoeken. Zie de Q#-API-verwijzing voor meer informatie. N/A
Foutopsporing: Foutopsporing starten .qs, .qasm, .qsc Opent het huidige programma in de debugger. Zie Foutopsporing en het testen van uw kwantumcode voor meer informatie. Druk op F5, selecteer de codelensoptie Debug naast de bewerking van het ingangspunt, of selecteer het pictogram Run in de rechterbovenhoek en selecteer vervolgens Start Debugging.
QDK: programma uitvoeren .qs, .qasm, .qsc Hiermee wordt het huidige programma uitgevoerd in de standaard kwantumsimulator. Zie Aan de slag met Q#-programma's voor meer informatie. Druk op Ctrl + F5, selecteer de CodeLens-optie Uitvoeren naast de beginpuntbewerking, of selecteer het pictogram Uitvoeren in de rechterbovenhoek en selecteer vervolgens Uitvoeren.

Deelvensterweergaven

Q#- en OpenQASM-programma's gebruiken de volgende weergaven in het deelvenster VS Code:

View Action
Debugconsole Uitvoer of foutopsporingsuitvoer weergeven
Problemen Geeft precompilatiefoutcontrole weer

Q#- en OpenQASM-code bewerken

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

  • Foutcontrole bij precompilatie
  • Ga naar definitie
  • References
  • Functiesignaturen
  • Parameterinformatie
  • Voltooiingssuggesties, waaronder contextbewuste voltooiingen, naamruimtelidvoltooiingen en voltooiingen van typeleden.
  • 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

De volgende tabellen bevatten opdrachten voor algemene taken wanneer u met de QDK-extensie werkt.

Werken met Q#-bestanden en -projecten

Opdracht Action Aantekeningen
Een nieuw Q#-bestand maken 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 Verkenner QDK: Q#-project maken vanuit het opdrachtpalet of klik met de rechtermuisknop op de map in Verkenner en selecteer Q#-project maken. Zie Werken met Q#-projecten voor meer informatie over Q#-projecten.
Een voorbeeldbestand maken Voer in een leeg .qs bestand .qasmvoorbeelden in en kies vervolgens een voorbeeldprogramma in de lijst met opties. U kunt ook in het opdrachtenpalet QDK: QDK-speeltuin openen selecteren om in Verkenner een online map met Q#- en OpenQASM-voorbeeldprogramma's te openen.

Verbinding maken met Azure Quantum

Opdracht Action Aantekeningen Alternatieve gebruikersactie
Verbinding maken met een Azure Quantum-werkruimte Selecteer het pictogram van het Microsoft quantumpaneel (linksonder). Selecteer een bestaande werkruimte toevoegen in Quantum-werkruimten. 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 Taken verzenden naar Azure Quantum met het QDK Python-pakket voor meer informatie. N/A

Programma's uitvoeren

Opdracht Action Aantekeningen Alternatieve gebruikersactie
Een Q# of OpenQASM-programma uitvoeren op de lokale kwantumsimulator Selecteer in een .qs of .qasm bestand 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# of OpenQASM-programma het pictogram Uitvoeren in de rechterbovenhoek en kies vervolgens Start Debugging. 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 Selecteer het pictogram van het Microsoft quantumpaneel (linksonder). Vouw vanuit Quantum-werkruimten de werkruimte uit en vouw vervolgens Providers uit om de beschikbare providers in de werkruimte weer te geven. 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/A
Een taak verzenden naar Azure Quantum Kies in een Q#- of OpenQASM-programma een werkruimte, provider en doel. Als u het huidige programma wilt verzenden, selecteert u de pijl naast het doel. Zie Taken verzenden naar Azure Quantum met de QDK-extensie voor VS Code voor meer informatie. N/A
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/A
  • Laatst bijgewerkt om