Referens: Microsoft Quantum Development Kit-tillägget för Visual Studio Code

Microsoft Quantum Development Kit (QDK) använder standardfunktionerna i Visual Studio Code (VS Code) tillsammans med språkspecifika funktioner när du arbetar med .qs- eller .qasm-filer. Den här referensguiden beskriver alla QDK-kommandon som du kan komma åt i VS Code-kommandopaletten, tillsammans med andra funktioner och länkar till ytterligare innehåll. Allmän VS Code-vägledning finns i VS Code-dokumentationen.

Tips/Råd

De flesta kommandon från QDK-tillägget är tillgängliga från menyn Visa > kommandopalett . När du är i en .qs- eller .qasm-fil, öppna kommandopaletten och ange QDK: för att visa en filtrerad lista med kommandon.

Commands

De flesta QDK-kommandona är relaterade till att skriva och köra Q#- och OpenQASM-program och är endast tillgängliga när en fil, .qs eller .qasm-fil, är aktiv. Andra kommandon fungerar i bakgrunden och är inte tillgängliga i kommandopaletten.

I följande tabell beskrivs kommandona från QDK-tillägget som visas i kommandopaletten.

Tips/Råd

Du kan skapa anpassade kortkommandon för VS Code-kommandon med kortkommandon eller Ctrl + K + S. Mer information finns i Nyckelbindningar för VS Code.

Kommando Action Notes Alternativ användaråtgärd
QDK: Skapa Q#-projekt Skapar ett Q#-projekt i den aktiva mappen, inklusive en qsharp.json manifestfil och en src undermapp med en standardfil main.qs . Mer information om Q#-projekt finns i Arbeta med Q#-projekt. I Utforskaren högerklickar du på målmappen och väljer Skapa Q#-projekt.
QDK: Skapa en Microsoft Quantum-notebook Öppnar ett Exempel på Jupyter Notebook som kör ett Q# + Python-program och skickar ett jobb till Azure Quantum. Mer information om QDK i Jupyter Notebook finns i Skicka jobb till Azure Quantum från Jupyter Notebook. N/A
QDK: Anslut till en Azure Quantum-arbetsyta Anslut till en Azure Quantum-arbetsyta med ditt Azure-konto eller en anslutningssträng. När du har autentiserats visas arbetsytan i Utforskaren i Quantum Workspaces. Mer information om Azure Quantum-anslutningar finns i Ansluta till din Azure Quantum-arbetsyta. Hovra över Quantum-arbetsytor i Utforskaren och välj ikonen + .
QDK: Öppen QDK-lekplats Öppnar en onlinemapp med Q# och OpenQASM-exempelprogram i Utforskaren. Du kan redigera och köra programmen i den lokala kvantsimulatorn och även ange brytpunkter och gå igenom koden med det inbyggda felsökningsprogrammet. Mer information finns i README-filen i exempelmappen. N/A
QDK: Uppdatera Azure Quantum arbetsområden Synkroniserar de senaste ändringarna från dina anslutna kvantarbetsytor. Om det uppstår ett anslutningsproblem visas en aviseringsikon bredvid arbetsytans namn. Hovra över Quantum Workspaces i Utforskaren och välj uppdateringsikonen.
Explorer: Fokusera på vyn för Quantum-arbetsytor Öppnar Utforskaren i Windows och fokuserar på dina anslutna kvantarbetsytor, om de är konfigurerade. Om inga arbetsytor har konfigurerats uppmanas du att lägga till en befintlig arbetsyta. Mer information om Azure Quantum-anslutningar finns i Ansluta till din Azure Quantum-arbetsyta. N/A

Följande kommandon är tillgängliga när en .qs eller .qasm en fil är aktiv.

Kommando Action Notes Alternativ användaråtgärd
QDK: Visa krets Visar ett kretsdiagram för programmet innan det körs. Mer information finns i Visualisera kvantkretsdiagram. Välj kodobjektivsalternativet Krets från menyn bredvid startpunktsåtgärden eller ovanför varje användardefinierad åtgärd i programmet.
QDK: Kör filen och visa histogram Kör det aktuella programmet och visar ett histogram över resultaten i ett nytt fönster. Om du vill komma åt sorterings- och filteralternativen för histogramvisningen väljer du filterikonen i histogramfönstret. Välj kodlinsalternativet Histogram från menyn bredvid ingångspunkt operationen.
QDK: Hämta QIR för aktuellt QDK-program Öppnar QIR-källan för den aktuella Q#- eller OpenQASM-koden i ett nytt redigeringsfönster. Programmet måste använda målprofilen Base, Adaptive RI eller Adaptive RIF för att exportera QIR-källa. Mer information om QIR finns i Mellanliggande kvantrepresentation och QDK-utvecklarbloggen. N/A
QDK: Beräkna resursuppskattningar Anropar den inbyggda versionen av resursberäknaren. Mer information finns i Introduktion till Microsoft Quantum-resursberäknaren. N/A
QDK: Hjälp En kort översikt över QDK-tillägget i VS Code. Fullständig Dokumentation om Microsoft Quantum finns i Microsoft Quantum-dokumentationen. N/A
QDK: Kör filen och visa kretsdiagram Kör det aktuella programmet och visar en krets i programmet med utdata. Mer information finns i Visualisera kvantkretsdiagram. N/A
QDK: Visa API-dokumentation Öppnar API-dokumentationen i ett nytt fönster. Om du vill söka i det här fönstret trycker du på Ctrl + F. Mer information finns i referensen Microsoft Quantum API. N/A
QDK: Visa ändringslogg Öppnar en ändringslogg på en ny flik som visar QDK-uppdateringarna för de aktuella och alla tidigare versioner. Ändringsloggen är också tillgänglig på QDK GitHub-lagringsplatsen med öppen källkod. N/A
Felsökning: Starta felsökning Öppnar det aktuella programmet i felsökningsprogrammet. Mer information finns i Felsöka och testa kvantkoden. Tryck på F5 eller välj kodobjektivalternativet Felsök på menyn bredvid startpunktsåtgärden, eller välj ikonen Kör i det övre högra hörnet och välj Starta felsökning.
Felsökning: Kör Kör det aktuella programmet i standard-kvantsimulatorn. Mer information finns i Kom igång med Q#-program. Tryck på Ctrl + F5 eller välj kodobjektivalternativet Kör från menyn bredvid startpunkten, eller välj ikonen Kör i det övre högra hörnet och välj Kör.

Terminaler

Q#- och OpenQASM-program använder två terminalfönster i VS Code:

Terminal Action
Felsökningskonsol Visar körningsutdata eller felsökningsutdata
Problem Visar förkompileringsfelkontroller

Redigera Q# och OpenQASM-kod

De flesta vanliga funktioner för kodredigering i VS Code är också tillgängliga när du arbetar med Q#- och OpenQASM-program:

  • Felkontroll för förkompilering
  • Gå till definition
  • Referenser
  • Funktionssignaturer
  • Parameterinformation
  • Slutförandeförslag, inklusive kontextmedvetna, namnområdesmedlemskomplettering och typmedlemskomplettering.
  • Linting – I Q#-filer konfigurerar du linting per-projekt i manifestfilen. Mer information finns i Arbeta med Q#-projekt.

För mer information, se Intellisense i VS Code-dokumentationen.

Vanliga uppgifter

Arbeta med Q#-filer och -projekt

Task Action Notes
Ny Q#-fil Välj Fil > Ny fil > Textfil. Spara filen med tillägget .qs. Om du anger Files: Default Language = qsharpkommer en ny fil automatiskt att använda Q#-formatering.
Skapa ett Q#-projekt Från en öppen mapp i Utforskaren väljer du Skapa Q#-projekt från kommandopaletten eller högerklickar på mappen i Utforskaren och väljer Skapa Q#-projekt. Mer information om Q#-projekt finns i Arbeta med Q#-projekt.
Exempelfiler I en tom .qs fil eller .qasm fil anger du exempel och väljer sedan ett exempelprogram i listan med alternativ. Du kan också välja Öppna QDK playground i kommandopaletten för att öppna en onlinemapp med Q# och OpenQASM-exempelprogram i Utforskaren.

Ansluta till Azure Quantum

Task Action Notes Alternativ användaråtgärd
Ansluta till en Azure Quantum-arbetsyta I Utforskaren expanderar du Kvantarbetsytor och väljer Lägg till en befintlig arbetsyta. Följ anvisningarna för att välja en prenumeration och arbetsyta. Du kan ansluta till flera arbetsytor. Välj + bredvid Quantum Workspaces för att ansluta en annan arbetsyta. Arbetsyteanslutningar bevaras mellan dina VS Code-sessioner. På kommandopaletten väljer du QDK: Anslut till en Azure Quantum-arbetsyta.
Ansluta programmatiskt med ett Python-program Högerklicka på en befintlig arbetsyteanslutning och välj Kopiera Python-kod för att ansluta till arbetsytan. Klistra in den resulterande koden i Python-programmet. Mer information finns i Skicka Python med Q#-jobb till Azure Quantum. N/A

Köra program

Task Action Notes Alternativ användaråtgärd
Kör ett Q#- eller OpenQASM-program på den lokala kvantsimulatorn I en .qs eller .qasm -fil väljer du ikonen Kör i det övre högra hörnet och väljer Kör. Mer information om kvantsimulatorn finns i sparse-kvantsimulatorn. Tryck Ctrl + F5, eller välj antingen QDK: Kör filen och visa histogram eller QDK: Kör filen och visa kretsdiagram i Kommandopaletten, eller välj alternativet Kör kodlins ovanför startpunkten.
Felsöka ett program I ett Q#- eller OpenQASM-program väljer du ikonen Kör i det övre högra hörnet och väljer Starta felsökning. Mer information om Q#-felsökningsprogrammet i VS Code finns i Felsöka och testa kvantkoden. Tryck på F5 eller välj Debug codelens från menyn ovanför startpunktsoperationen.
Visa leverantörer och mål på dina arbetsytor I Utforskaren väljer du Kvantarbetsytor, expanderar arbetsytan och expanderar sedan Providers för att se tillgängliga leverantörer på arbetsytan. Expandera en enskild leverantör för att visa tillgängliga mål. Hovra över ett målnamn för att visa dess status och kötid innan du skickar ett jobb. N/A
Skicka ett jobb till Azure Quantum I ett Q#- eller OpenQASM-program väljer du en arbetsyta, leverantör och ett mål. Om du vill skicka det aktuella programmet väljer du pilen bredvid målet. Mer information finns i Skicka Q#-jobb till Azure Quantum. N/A
Visa jobbresultat Expandera arbetsytan och sedan öppna upp Jobb. Om du vill öppna jobbutdata från Azure Storage väljer du molnikonen bredvid jobbnamnet. Jobb visas från den senaste till den äldsta. N/A
  • Last updated on