Informazioni di riferimento: Estensione Azure Quantum Development Kit per Visual Studio Code
Azure Quantum Development Kit (QDK) usa tutte le funzionalità standard di Visual Studio (VS) Code, insieme alle funzionalità specifiche di Q#, quando si usano file con estensione qs. Questo articolo è una guida di riferimento a tutti i comandi e le funzionalità correlati a Q#, con collegamenti a contenuto aggiuntivo in base alle esigenze. Per indicazioni generali su VS Code, vedere la documentazione di VS Code.
Suggerimento
È possibile accedere alla maggior parte dei comandi correlati a Q# dal menu Visualizza > riquadro comandi. In un file con estensione qs selezionare CTRL-MAIUSC-P (Cmd-SHIFT-P in macOS) e immettere Q# per visualizzare un elenco filtrato di comandi.
Per tutti i tasti di scelta rapida macOS, vedi Tasti di scelta rapida per macOS.
Comandi
È possibile accedere alla maggior parte dei comandi correlati a Q# dal menu Visualizza > riquadro comandi. Selezionare CTRL-MAIUSC-P e immettere Q# per visualizzare un elenco filtrato di comandi. Alcuni comandi sono disponibili solo quando è attivo un file con estensione qs.
Suggerimento
È possibile creare tasti di scelta rapida personalizzati per qualsiasi comando 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 | Azione | Note | Azione utente alternativa |
|---|---|---|---|
| D#: Creare un progetto Q# | Crea un progetto Q# nella cartella attiva, tra cui: * un file manifesto qsharp.json * una sottocartella src con un file main.qs predefinito. |
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#. |
| D#: Creare un notebook di Azure Quantum | Apre un notebook jupyter di esempio che esegue un programma Q# + Python e invia un processo ad Azure Quantum. | Per altre informazioni sui notebook di Azure Quantum, vedere Usare i notebook di Azure Quantum. | N/D |
| Q#: 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 "+". |
| Q#: Aprire il playground Q# | Apre una cartella online di programmi di esempio Q# 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/D |
| D#: 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. |
| Esplora risorse: Concentrarsi sulla visualizzazione 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/D |
I comandi seguenti sono disponibili quando è attivo un file con estensione qs.
| Comando | Azione | Note | Azione utente alternativa |
|---|---|---|---|
| Q#: Impostare il profilo di destinazione di Azure Quantum QIR | Imposta il qiR, o la rappresentazione intermedia quantistica, profilo di destinazione per i programmi Q#. | Per altre informazioni sui profili di destinazione, vedere Profili di destinazione. | Il profilo di destinazione corrente viene visualizzato nella barra degli strumenti inferiore. Selezionare il profilo di destinazione sulla barra degli strumenti per aprire l'elenco a discesa di selezione. |
| Q#: Mostra circuito | Visualizza un diagramma del circuito per il programma Q# 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. |
| Q#: Eseguire il file e visualizzare l'istogramma | Esegue il programma Q# corrente e visualizza un istogramma dei risultati nel riquadro destro. | 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 Istogram dal menu accanto all'operazione del punto di ingresso. |
| Q#: Ottenere QIR per il programma Q# corrente | Apre l'origine QIR per il codice Q# corrente in una nuova finestra di modifica. Il programma deve usare il profilo di destinazione dell'istanza riservata adattiva o di base per esportare l'origine QIR. | Per altre informazioni su QIR, vedere Rappresentazione intermedia quantistica e blog per sviluppatori Q#. | N/D |
| Debug: Eseguire il debug del file Q# | Apre il programma Q# corrente nel debugger. | Per altre informazioni, vedere Debug e test del codice quantistico. | * Selezionare F5 * Selezionare l'opzione code lens Debug dal menu accanto all'operazione del punto di ingresso. * Selezionare l'icona Esegui in alto a destra e selezionare Debug file Q#. |
| Debug: eseguire il file Q# | Esegue il programma Q# corrente nel simulatore quantistico predefinito. | Per altre informazioni, vedere Introduzione ai programmi Q#. | * Selezionare CTRL+F5 * Selezionare l'opzione code lens Esegui dal menu accanto all'operazione del punto di ingresso. * Selezionare l'icona Esegui in alto a destra e selezionare Esegui file Q#. |
| Q#: Calcolare le stime delle risorse | Richiama la versione predefinita di Resource Estimator. | Per altre informazioni, vedere Introduzione allo strumento di stima delle risorse di Azure Quantum. | N/D |
| Q#: Guida | Breve panoramica dell'estensione QDK in VS Code. | Per la documentazione completa di Azure Quantum, vedere la documentazione di Azure Quantum. | N/D |
| Q#: Eseguire il file e visualizzare il diagramma del circuito | Esegue il programma Q# corrente e visualizza un circuito del programma con output. | Per altre informazioni, vedere Visualizzare diagrammi di circuiti quantistici. | N/D |
| Q#: Visualizzare la documentazione dell'API | Apre la documentazione dell'API in un nuovo riquadro. Eseguire ricerche in questo riquadro usando CTRL+F. | Per altre informazioni, vedere le informazioni di riferimento sulle API di Azure Quantum. | N/D |
Terminali
I programmi Q# usano due finestre del terminale in VS Code:
| Terminale | Azione |
|---|---|
| Console di debug | Visualizza l'output di esecuzione o l'output di debug |
| Problematica | Visualizza i controlli degli errori di precompilata |
Modifica del codice Q#
La maggior parte delle funzionalità comuni di modifica del codice in VS Code è disponibile quando si lavora con programmi Q#. Per altre informazioni, vedere Intellisense nella documentazione di VS Code.
- Controllo degli errori di precompilazione
- Definizione go-to
- Riferimenti
- Firme di funzione
- Informazioni sui parametri
- Suggerimenti di completamento, inclusi il riconoscimento del contesto, il membro dello spazio dei nomi e i 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#.
Attività comuni
Uso di file e progetti Q#
| Attività | Azione | Note |
|---|---|---|
| Nuovo file Q# | Selezionare File > Nuovo file >Di testo. Salvare il file con estensione qs. | Se si imposta Files: Default Language = qsharp, per impostazione predefinita un nuovo file è la 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 con estensione qs vuoto immettere esempi e quindi selezionare un programma di esempio dall'elenco. | È anche possibile selezionare Apri playground Q# nel riquadro comandi per aprire una cartella online di programmi di esempio Q# in Esplora file. |
Connessione ad Azure Quantum
| Attività | Azione | 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. * Per rimuovere una connessione all'area di lavoro, fare clic con il pulsante destro del mouse sull'area di lavoro e selezionare Rimuovi connessione all'area di lavoro. |
Nel riquadro comandi selezionare 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/D |
Esecuzione di programmi
| Attività | Azione | Note | Azione utente alternativa |
|---|---|---|---|
| Eseguire un programma Q# nel simulatore quantistico locale | In un programma Q# selezionare l'icona Esegui in alto a destra e selezionare Esegui file Q#. | Per altre informazioni sul simulatore quantistico, vedere il simulatore quantistico sparse. | * Selezionare CTRL+F5 * Dal riquadro comandi selezionare Q#: Esegui file e mostra istogramma o Q#: Esegui file e mostra diagramma circuito * Selezionare l'opzione code lens Esegui dal menu accanto all'operazione del punto di ingresso. |
| Eseguire il debug di un programma | In un programma Q# selezionare l'icona Esegui in alto a destra e selezionare Debug file Q#. | Per altre informazioni sul debugger Q# in VS Code, vedere Debug e test del codice quantistico. | * Selezionare F5 * Selezionare l'opzione code lens Debug dal menu accanto all'operazione del punto di ingresso. |
| Visualizzare provider e destinazioni nelle aree 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. | Nota: passare il puntatore del mouse su un nome di destinazione per visualizzarne lo stato e l'ora della coda prima di inviare un processo. | N/D |
| Inviare un processo ad Azure Quantum | In un programma Q# selezionare un'area di lavoro, un provider e una destinazione. Per inviare il programma Q# corrente, selezionare la freccia accanto alla destinazione. | Per altre informazioni, vedere Invio di processi Q# ad Azure Quantum. | N/D |
| Visualizzare i risultati del processo | Espandere l'area di lavoro e quindi espandere Processi. Per aprire l'output del processo da Archiviazione di Azure, selezionare l'icona cloud accanto al nome del processo. | I processi sono elencati con l'elemento più recente nella parte superiore. | N/D |