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

Microsoft Quantum Development Kit (QDK) använder alla standardfunktioner i Visual Studio Code (VS Code) tillsammans med Q#-specifika funktioner när du arbetar med .qs 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

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

Kommandon

De flesta QDK-kommandon är relaterade till att skriva och köra Q#-program och är endast tillgängliga när en .qs 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

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	Åtgärd	Anteckningar	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 Microsoft Quantum-notebooks finns i Arbeta med Microsoft Quantum Notebooks.	Ej tillämpligt
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#-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.	Ej tillämpligt
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.	Ej tillämpligt

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

Kommando	Åtgärd	Anteckningar	Alternativ användaråtgärd
QDK: Visa krets	Visar ett kretsdiagram för Q#-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 Q#-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#-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 Q#- utvecklarbloggen.	Ej tillämpligt
QDK: Beräkna resursuppskattningar	Anropar den inbyggda versionen av resursberäknaren.	Mer information finns i Introduktion till Microsoft Quantum-resursberäknaren.	Ej tillämpligt
QDK: Hjälp	En kort översikt över QDK-tillägget i VS Code.	Fullständig Dokumentation om Microsoft Quantum finns i Microsoft Quantum-dokumentationen.	Ej tillämpligt
QDK: Kör filen och visa kretsdiagram	Kör det aktuella Q#-programmet och visar en krets i programmet med utdata.	Mer information finns i Visualisera kvantkretsdiagram.	Ej tillämpligt
QDK: Lägg till Copilot-instruktionsfil för Q# och OpenQASM	Öppnar en uppmaning som ger dig möjlighet att lägga till Copilot-instruktioner som hjälper dig att skriva och köra Q# anf OpenQASM-kod.	Mer information finns i Konfigurera agentläge i VS Code för Microsoft Quantum Development Kit.	Ej tillämpligt
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 för Azure Quantum API.	Ej tillämpligt
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.	Ej tillämpligt
Felsökning: Starta felsökning	Öppnar det aktuella Q#-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 Q#-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#-program använder två terminalfönster i VS Code:

Terminal	Åtgärd
Felsökningskonsol	Visar körningsutdata eller felsökningsutdata
Problem	Visar förkompileringsfelkontroller

Redigera Q#-kod

De flesta vanliga kodredigeringsfunktioner i VS Code är också tillgängliga när du arbetar med Q#-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 åtgärder

Arbeta med Q#-filer och -projekt

Uppgift	Åtgärd	Anteckningar
Ny Q#-fil	Välj Fil > Ny fil > Textfil. Spara filen med ett .qs tillägg.	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 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#-exempelprogram i Utforskaren.

Ansluta till Azure Quantum

Uppgift	Åtgärd	Anteckningar	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.	Ej tillämpligt

Köra program

Uppgift	Åtgärd	Anteckningar	Alternativ användaråtgärd
Köra ett Q#-program på den lokala kvantsimulatorn	I ett Q#-program 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#-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.	Ej tillämpligt
Skicka ett jobb till Azure Quantum	I ett Q#-program väljer du en arbetsyta, leverantör och ett mål. Om du vill skicka det aktuella Q#-programmet väljer du pilen bredvid målet.	Mer information finns i Skicka Q#-jobb till Azure Quantum.	Ej tillämpligt
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.	Ej tillämpligt