Referens: Azure Quantum Development Kit-tillägget för Visual Studio Code
Azure Quantum Development Kit (QDK) använder alla standardfunktioner i Visual Studio(VS) Code, tillsammans med Q#-specifika funktioner när du arbetar med .qs-filer. Den här artikeln är en referensguide till alla Q#-relaterade kommandon och funktioner, med länkar till ytterligare innehåll efter behov. Allmän VS Code-vägledning finns i VS Code-dokumentationen.
Dricks
De flesta Q#-relaterade kommandon kan nås från menyn Visa > kommandopalett . I en .qs-fil väljer du Ctrl-Skift-P (Cmd-Shift-P på macOS) och anger Q# för att visa en filtrerad lista med kommandon.
Alla kortkommandon för macOS finns i Kortkommandon för macOS.
Kommandon
De flesta Q#-relaterade kommandon kan nås från menyn Visa > kommandopalett . Välj Ctrl-Skift-P och ange Q# för att visa en filtrerad lista med kommandon. Vissa kommandon är bara tillgängliga när en .qs-fil är aktiv.
Dricks
Du kan skapa anpassade kortkommandon för valfritt VS Code-kommando med kortkommandon eller Ctrl+K+S. Mer information finns i Nyckelbindningar för VS Code.
| Command | Åtgärd | Kommentar | Alternativ användaråtgärd |
|---|---|---|---|
| Q#: Skapa Q#-projekt | Skapar ett Q#-projekt i den aktiva mappen, inklusive: * en qsharp.json manifestfil * en src-undermapp med en main.qs-standardfil. |
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. |
| Q#: Skapa en Azure Quantum-notebook-fil | Öppnar ett Exempel på Jupyter Notebook som kör ett Q# + Python-program och skickar ett jobb till Azure Quantum. | Mer information om Azure Quantum-notebook-filer finns i Arbeta med Azure Quantum Notebooks. | Ej tillämpligt |
| Q#: 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. | I Utforskaren hovrar du över Quantum-arbetsytor och väljer ikonen "+". |
| Q#: Öppna Q# playground | Ö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 |
| Q#: Uppdatera Azure Quantum-arbetsytor | Synkroniserar de senaste ändringarna från dina anslutna kvantarbetsytor. | Om det uppstår ett anslutningsproblem visas en aviseringsikon bredvid arbetsytans namn. | Hovra över Quantum-arbetsytor i Utforskaren och välj uppdateringsikonen. |
| Explorer: Fokusera på vyn Kvantarbetsytor | Öppnar Utforskaren och fokuserar på dina anslutna kvantarbetsytor om det är konfigurerat. 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.
| Command | Åtgärd | Kommentar | Alternativ användaråtgärd |
|---|---|---|---|
| Q#: Ange Azure Quantum QIR-målprofilen | Anger målprofilen för QIR, eller kvantintermediär representation, för dina Q#-program. | Mer information om målprofiler finns i Målprofiler. | Den aktuella målprofilen visas i det nedre verktygsfältet. Välj målprofilen i verktygsfältet för att öppna listrutan för markeringen. |
| Q#: 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. |
| Q#: Kör filen och visa histogram | Kör det aktuella Q#-programmet och visar ett histogram över resultaten i den högra rutan. | Om du vill komma åt sorterings- och filteralternativ för histogramvisningen väljer du filterikonen i histogramfönstret. | Välj alternativet Histogram för kodlinsen på menyn bredvid startpunktsåtgärden. |
| Q#: Hämta QIR för det aktuella Q#-programmet | Öppnar QIR-källan för den aktuella Q#-koden i ett nytt redigeringsfönster. Programmet måste använda bas- eller adaptiv RI-målprofilen för att exportera QIR-källa. | Mer information om QIR finns i Mellanliggande kvantrepresentation och Q#- utvecklarbloggen. | Ej tillämpligt |
| Felsökning: FelsökA Q#-fil | Öppnar det aktuella Q#-programmet i felsökningsprogrammet. | Mer information finns i Felsöka och testa kvantkoden. | * Välj F5 * Välj kodobjektivalternativet Felsök på menyn bredvid startpunkten. * Välj ikonen Kör i det övre högra hörnet och välj FelsökA Q#-fil. |
| Felsökning: Kör Q#-fil | Kör det aktuella Q#-programmet i standard-kvantsimulatorn. | Mer information finns i Kom igång med Q#-program. | * Välj Ctrl+F5 * Välj kodobjektivsalternativet Kör från menyn bredvid startpunktsåtgärden. * Välj ikonen Kör i det övre högra hörnet och välj Kör Q#-fil. |
| Q#: Beräkna resursuppskattningar | Anropar den inbyggda versionen av Resource Estimator. | Mer information finns i Introduktion till Azure Quantum Resource Estimator. | Ej tillämpligt |
| Q#: Hjälp | En kort översikt över QDK-tillägget i VS Code. | Fullständig Dokumentation om Azure Quantum finns i Dokumentation om Azure Quantum. | Ej tillämpligt |
| Q#: 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 |
| Q#: Visa API-dokumentation | Öppnar API-dokumentationen i ett nytt fönster. Sök i det här fönstret med Ctrl-F. | Mer information finns i referensen för Azure Quantum API. | Ej tillämpligt |
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 funktioner för kodredigering i VS Code är tillgängliga när du arbetar med Q#-program. Mer information finns i Intellisense i VS Code-dokumentationen.
- Felkontroll för förkompilering
- Gå till definition
- Referenser
- Funktionssignaturer
- Parameterinformation
- Förslag på slutförande
- Linting – I Q#-filer konfigurerar du linting per projekt i manifestfilen. Mer information finns i Arbeta med Q#-projekt.
Vanliga åtgärder
Arbeta med Q#-filer och -projekt
| Uppgift | Åtgärd | Kommentar |
|---|---|---|
| Ny Q#-fil | Välj Fil > Ny fil > Textfil. Spara filen med filnamnstillägget .qs. | Om du anger Files: Default Language = qsharpkommer en ny fil som standard att formatera Q# automatiskt. |
| 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. | Du kan också välja Öppna Q#-lekplats i kommandopaletten för att öppna en onlinemapp med Q#-exempelprogram i Utforskaren. |
Ansluta till Azure Quantum
| Uppgift | Åtgärd | Kommentar | Alternativ användaråtgärd |
|---|---|---|---|
| Ansluta till en Azure Quantum-arbetsyta | I Utforskaren expanderar du Quantum-arbetsytor 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-arbetsytor för att ansluta en annan arbetsyta. Arbetsyteanslutningar bevaras mellan dina VS Code-sessioner. * Om du vill ta bort en arbetsyteanslutning högerklickar du på arbetsytan och väljer Ta bort anslutning till arbetsytan. |
På kommandopaletten väljer du 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 | Kommentar | 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 Q#-fil. | Mer information om kvantsimulatorn finns i sparse-kvantsimulatorn. | * Välj Ctrl-F5 * Välj Q#: Kör filen från kommandopaletten och visa histogram eller Q#: Kör filen och visa kretsdiagram * Välj kodobjektivsalternativet Kör från menyn bredvid startpunktsåtgärden. |
| Felsöka ett program | I ett Q#-program väljer du ikonen Kör i det övre högra hörnet och väljer FelsökA Q#-fil. | Mer information om Q#-felsökningsprogrammet i VS Code finns i Felsöka och testa kvantkoden. | * Välj F5 * Välj kodobjektivalternativet Felsök på menyn bredvid startpunkten. |
| 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 provider för att visa tillgängliga mål. | Obs! 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 expandera sedan Jobb. Om du vill öppna jobbutdata från Azure Storage väljer du molnikonen bredvid jobbnamnet. | Jobb visas med den senaste överst. | Ej tillämpligt |