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 i comandi QDK principali 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.

La maggior parte dei comandi dell'estensione QDK è accessibile dal menu Visualizza > Palette comandi. Aprire il Riquadro comandi e immettere QDK: per visualizzare un elenco filtrato di comandi in un file .qs, .qasm o .qsc.

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.

Comandi

Molti dei comandi QDK sono correlati alla scrittura e all'esecuzione di programmi Q# e OpenQASM e sono disponibili solo quando è attivo un .qsfile , .qasmo .qsc . Altri comandi sono disponibili a livello generale.

Comandi generali

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 altre informazioni sul QDK in Jupyter Notebook, vedere Inviare processi a Azure Quantum con il pacchetto di Python QDK.	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 aver eseguito l'autenticazione, selezionare l'icona Microsoft pannello Quantum (in basso a sinistra).	Per altre informazioni sulle connessioni di Azure Quantum, vedere Connettersi all'area di lavoro di Azure Quantum.	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.	Passare il puntatore del mouse sulle aree di lavoro quantistiche e selezionare l'icona di aggiornamento.
QDK: Creare un ambiente virtuale Microsoft Quantum Python	Crea una cartella e installa un ambiente virtuale Python con i pacchetti selezionati.	Disponibile in VS Code desktop, ma non in VS Code per il Web.	N/A
QDK: Sfera Bloch	Apre il visualizzatore della sfera Bloch.	Per altre informazioni, vedere Come usare il visualizzatore di sfera Bloch in QDK.	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
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

Comandi disponibili in base al tipo di file attivo

Comando	Tipi di file di programma	Action	Note	Azione utente alternativa
QDK: Mostra circuito	.qs, .qasm	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	.qs, .qasm	Esegue il programma corrente e visualizza un istogramma dei risultati in un nuovo riquadro.	Per accedere alle opzioni di ordinamento e filtro, 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	.qs, .qasm	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	.qs, .qasm	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	.qs	Apre una breve panoramica dell'estensione QDK in VS Code.	N/A	N/A
QDK: Eseguire il file e visualizzare il diagramma del circuito	.qs, .qasm	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	.qs	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 sulle API Q#.	N/A
Debug: avviare il debug	.qs, .qasm, .qsc	Apre il programma corrente nel debugger.	Per altre informazioni, vedere Debug e test del codice quantistico.	Premere F5, selezionare l'opzione code lens Debug accanto all'operazione del punto di ingresso oppure selezionare l'icona Esegui nell'angolo in alto a destra e quindi selezionare Avvia debug.
QDK: Eseguire il programma	.qs, .qasm, .qsc	Esegue il programma corrente nel simulatore quantistico predefinito.	Per altre informazioni, vedere Introduzione ai programmi Q#.	Premere Ctrl + F5, selezionare l'opzione CodeLens Esegui accanto all'operazione del punto di ingresso oppure selezionare l'icona Esegui nell'angolo in alto a destra e quindi selezionare Esegui.

Visualizzazioni del pannello

I programmi Q# e OpenQASM usano le visualizzazioni seguenti nel pannello di VS Code:

View	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 i completamenti basati sul contesto, dei membri di spazi dei nomi e dei membri dei tipi.
• 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

Le tabelle seguenti elencano i comandi per le attività comuni quando si usa l'estensione QDK.

Usare file e progetti Q#

Task	Action	Note
Creare un 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 QDK: Crea progetto Q# dal riquadro comandi oppure fare clic con il pulsante destro del mouse sulla cartella in Esplora file e scegliere Crea progetto Q#.	Per altre informazioni sui progetti Q#, vedere Uso di progetti Q#.
Creare un 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 QDK: Aprire il 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	Selezionare l'icona Microsoft pannello Quantum (in basso a sinistra). In Aree di lavoro quantistiche 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 Inviare processi a Azure Quantum con il pacchetto di Python QDK.	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 quindi 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	Selezionare l'icona Microsoft pannello Quantum (in basso a sinistra). Da Quantum Workspaces, espandere l'area di lavoro e quindi espandere Providers 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 Inviare processi a Azure Quantum con l'estensione QDK per VS Code.	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