Riferimento: Estensione Microsoft Quantum Development Kit per Visual Studio Code

Il Microsoft Quantum Development Kit (QDK) usa la funzionalità standard di Visual Studio Code (VS Code), insieme alle funzionalità specifiche del linguaggio quando si usano file .qs o .qasm. Questa guida di riferimento descrive tutti i comandi QDK a cui è possibile accedere nel riquadro comandi di VS Code, insieme ad altre funzionalità e collegamenti a contenuto aggiuntivo. Per indicazioni generali su VS Code, vedere la documentazione di VS Code.

Tip

La maggior parte dei comandi dell'estensione QDK è accessibile dal menu Visualizza > Palette comandi. Quando ci si trova in un file .qs o .qasm, aprire la tavolozza dei comandi e immettere QDK: per visualizzare un elenco filtrato di comandi.

Comandi

La maggior parte dei comandi QDK è correlata alla scrittura e all'esecuzione di programmi Q# e OpenQASM e sono disponibili solo quando un .qs file o .qasm è attivo. Altri comandi funzionano in background e non sono accessibili nel riquadro comandi.

La tabella seguente descrive i comandi dell'estensione QDK visualizzati nel riquadro comandi.

Tip

È possibile creare tasti di scelta rapida personalizzati per i comandi di VS Code usando i tasti di scelta rapida o CTRL + K + S. Per altre informazioni, vedere Tasti di scelta rapida per VS Code.

Comando	Action	Note	Azione utente alternativa
QDK: Creare un progetto Q#	Crea un progetto Q# nella cartella attiva, inclusi un qsharp.json file manifesto e una src sottocartella con un file predefinito main.qs .	Per altre informazioni sui progetti Q#, vedere Uso di progetti Q#.	In Esplora file fare clic con il pulsante destro del mouse sulla cartella di destinazione e scegliere Crea progetto Q#.
QDK: Creare un notebook di Microsoft Quantum	Apre un Notebook Jupyter di esempio che esegue un programma Q# + Python e invia un job ad Azure Quantum.	Per ulteriori informazioni sul QDK in Jupyter Notebook, consultare Inviare processi ad Azure Quantum da Jupyter Notebook.	N/A
QDK: Connettersi a un'area di lavoro di Azure Quantum	Connettersi a un'area di lavoro di Azure Quantum usando l'account Azure o un stringa di connessione. Dopo l'autenticazione, l'area di lavoro viene visualizzata in Esplora file in Aree di lavoro quantistiche.	Per altre informazioni sulle connessioni di Azure Quantum, vedere Connettersi all'area di lavoro di Azure Quantum.	In Esplora file passare il puntatore del mouse sulle aree di lavoro quantistiche e selezionare l'icona + .
QDK: Apri il playground QDK	Apre una cartella online di programmi di esempio Q# e OpenQASM in Esplora file. È possibile modificare ed eseguire i programmi nel simulatore quantistico locale, nonché impostare punti di interruzione ed eseguire il codice con il debugger predefinito.	Per altre informazioni, vedere il file README nella cartella di esempio.	N/A
QDK: Aggiornare le aree di lavoro di Azure Quantum	Sincronizza le modifiche più recenti dalle aree di lavoro quantistiche connesse.	Se si verifica un problema di connessione, accanto al nome dell'area di lavoro viene visualizzata un'icona di avviso.	In Esplora file passare il puntatore del mouse sulle aree di lavoro quantistiche e selezionare l'icona di aggiornamento.
Esploratore: Mettere a fuoco Aree di lavoro quantistiche	Apre Esplora file e si concentra sulle aree di lavoro quantistiche connesse, se configurate. Se non sono configurate aree di lavoro, viene richiesto di aggiungere un'area di lavoro esistente.	Per altre informazioni sulle connessioni di Azure Quantum, vedere Connettersi all'area di lavoro di Azure Quantum.	N/A

I comandi seguenti sono disponibili quando un .qs file o .qasm è attivo.

Comando	Action	Note	Azione utente alternativa
QDK: Mostra circuito	Visualizza un diagramma di circuito per il programma prima dell'esecuzione.	Per altre informazioni, vedere Visualizzare diagrammi di circuiti quantistici.	Selezionare l'opzione code lens Circuit (Circuito ) dal menu accanto all'operazione del punto di ingresso o sopra ogni operazione definita dall'utente nel programma.
QDK: eseguire il file e visualizzare l'istogramma	Esegue il programma corrente e visualizza un istogramma dei risultati in un nuovo riquadro.	Per accedere alle opzioni di ordinamento e filtro per la visualizzazione dell'istogramma, selezionare l'icona del filtro nel riquadro istogramma.	Selezionare l'opzione code lens Istogramma dal menu accanto all'operazione del punto di ingresso.
QDK: Ottenere QIR per il programma QDK corrente	Apre il sorgente QIR per il codice Q# o OpenQASM corrente in una nuova finestra di editor. Il programma deve usare il profilo di destinazione Base, RI adattivo o RIF adattivo per esportare la sorgente QIR.	Per altre informazioni su QIR, vedere Rappresentazione intermedia quantistica e blog per sviluppatori QDK.	N/A
QDK: Calcolare le stime delle risorse	Richiama la versione predefinita dello strumento di stima delle risorse.	Per altre informazioni, vedere Introduzione allo strumento di stima delle risorse Microsoft Quantum.	N/A
QDK: Guida	Breve panoramica dell'estensione QDK in VS Code.	Per la documentazione completa di Microsoft Quantum, vedere la documentazione di Microsoft Quantum.	N/A
QDK: Eseguire il file e visualizzare il diagramma del circuito	Esegue il programma corrente e visualizza un circuito del programma con output.	Per altre informazioni, vedere Visualizzare diagrammi di circuiti quantistici.	N/A
QDK: Visualizzare la documentazione dell'API	Apre la documentazione dell'API in un nuovo riquadro. Per eseguire ricerche in questo riquadro, premere CTRL+F.	Per altre informazioni, vedere le informazioni di riferimento Microsoft API Quantum.	N/A
QDK: Mostra log delle modifiche	Apre un log delle modifiche in una nuova scheda che mostra gli aggiornamenti QDK per le versioni correnti e tutte le versioni precedenti.	Il log delle modifiche è disponibile anche nel repository GitHub QDK open source.	N/A
Debug: avviare il debug	Apre il programma corrente nel debugger.	Per altre informazioni, vedere Debug e test del codice quantistico.	Premere F5 oppure selezionare l'opzione Debug dell'obiettivo del codice dal menu accanto all'operazione del punto di ingresso oppure selezionare l'icona Esegui in alto a destra e scegliere Avvia debug.
Debug: Esegui	Esegue il programma corrente nel simulatore quantistico predefinito.	Per altre informazioni, vedere Introduzione ai programmi Q#.	Premere Ctrl + F5 oppure selezionare l'opzione codice lens Esegui dal menu accanto all'operazione del punto di ingresso, oppure selezionare l'icona Esegui in alto a destra e scegliere Esegui.

Terminali

I programmi Q# e OpenQASM usano due finestre del terminale in VS Code:

Terminale	Action
Console di debug	Visualizza l'output di esecuzione o l'output di debug
Problematica	Visualizza i controlli degli errori di precompilata

Modificare il codice Q# e OpenQASM

La maggior parte delle funzionalità di modifica del codice comuni in VS Code è disponibile anche quando si lavora con i programmi Q# e OpenQASM:

• Controllo degli errori di precompilazione
• Vai a definizione
• References
• Definizioni di funzione
• Informazioni sui parametri
• Suggerimenti di completamento (inclusi completamenti sensibili al contesto, completamenti dei membri dello spazio dei nomi e completamenti dei membri del tipo).
• Linting: nei file Q# si configura l'linting per progetto nel file manifesto. Per altre informazioni, vedere Uso di progetti Q#.

Per altre informazioni, vedere Intellisense nella documentazione di VS Code.

Attività comuni

Usare file e progetti Q#

Task	Action	Note
Nuovo file Q#	Selezionare File > Nuovo file > File di testo. Salvare il file con un'estensione .qs .	Se si imposta Files: Default Language = qsharp, per impostazione predefinita un nuovo file viene impostato automaticamente sulla formattazione Q#.
Creare un progetto Q#	Da una cartella aperta in Esplora file selezionare Crea progetto Q# dal riquadro comandi oppure fare clic con il pulsante destro del mouse sulla cartella in Esplora file e selezionare Crea progetto Q#.	Per altre informazioni sui progetti Q#, vedere Uso di progetti Q#.
File di esempio	In un file .qs o .qasm vuoto, immettere esempi, e quindi scegliere un programma di esempio dall'elenco di opzioni.	È anche possibile selezionare Apri playground QDK nel riquadro comandi per aprire una cartella online di programmi di esempio Q# e OpenQASM in Esplora file.

Connettersi ad Azure Quantum

Task	Action	Note	Azione utente alternativa
Connettersi a un'area di lavoro di Azure Quantum	In Esplora file espandere Aree di lavoro quantistiche e selezionare Aggiungi un'area di lavoro esistente. Seguire le istruzioni per selezionare una sottoscrizione e un'area di lavoro.	È possibile connettersi a più aree di lavoro. Selezionare + accanto ad Aree di lavoro quantistiche per connettere un'altra area di lavoro. Le connessioni all'area di lavoro vengono mantenute tra le sessioni di VS Code.	Nel riquadro comandi selezionare QDK: Connetti a un'area di lavoro di Azure Quantum.
Connettersi a livello di codice con un programma Python	Fare clic con il pulsante destro del mouse su una connessione all'area di lavoro esistente e selezionare Copia codice Python per connettersi all'area di lavoro. Incollare il codice risultante nel programma Python.	Per altre informazioni, vedere Invio di processi Python con Q# ad Azure Quantum.	N/A

Eseguire programmi

Task	Action	Note	Azione utente alternativa
Eseguire un programma Q# o OpenQASM nel simulatore quantistico locale	In un .qs file o .qasm selezionare l'icona Esegui in alto a destra e selezionare Esegui.	Per ulteriori informazioni sul simulatore quantistico, vedere il simulatore quantistico Sparse.	Premere Ctrl + F5, oppure scegliere QDK: Esegui file e mostra l'istogramma o QDK: Esegui file e mostra il diagramma del circuito nella Palette Comandi, oppure scegliere l'opzione di Esegui sopra l'operazione di punto di ingresso.
Eseguire il debug di un programma	In un programma Q# o OpenQASM selezionare l'icona Esegui in alto a destra e scegliere Avvia debug.	Per altre informazioni sul debugger Q# in VS Code, vedere Debug e test del codice quantistico.	Premere F5 oppure scegliere l'obiettivo del codice Debug dal menu sopra l'operazione del punto di ingresso.
Visualizza provider e destinazioni nel tuo spazio di lavoro	In Esplora file selezionare Aree di lavoro quantistiche, espandere l'area di lavoro e quindi espandere Provider per visualizzare i provider disponibili nell'area di lavoro. Espandere un singolo provider per visualizzare le destinazioni disponibili.	Passare il puntatore del mouse su un nome di destinazione per visualizzarne lo stato e il tempo di attesa prima di inviare un processo.	N/A
Inviare un'attività ad Azure Quantum	In un programma Q# o OpenQASM scegliere un'area di lavoro, un provider e una destinazione. Per inviare il programma corrente, selezionare la freccia accanto alla destinazione.	Per altre informazioni, vedere Invio di processi Q# ad Azure Quantum.	N/A
Visualizzare i risultati del lavoro	Espandi l'area di lavoro e quindi espandi Lavori. Per aprire l'output del job da Archiviazione di Azure, selezionare l'icona a forma di cloud accanto al nome del job.	I lavori vengono elencati dal più recente al meno recente.	N/A