Référence : Microsoft Quantum Development Kit extension de Visual Studio Code

Le Microsoft Quantum Development Kit (QDK) utilise les fonctionnalités standard de Visual Studio Code (VS Code), ainsi que les fonctionnalités spécifiques au langage lorsque vous travaillez avec des fichiers .qasm ou .qs. Ce guide de référence décrit les commandes principales QDK de la VS Code palette de commandes, ainsi que d’autres fonctionnalités et liens vers plus de contenu. Pour obtenir des conseils généraux VS Code , consultez la VS Code documentation.

Pour rechercher QDK des commandes, sélectionnez Afficher > la palette de commandes et entrez QDK: ou Microsoft Quantum:. Certaines commandes s’affichent uniquement lorsqu’un fichier pris en charge ou une vue prise en charge est actif.

Conseil / Astuce

Créez des raccourcis clavier personnalisés pour les commandes VS Code à l’aide des raccourcis clavier ou en appuyant sur Ctrl + K + S. Pour plus d’informations, consultez Raccourcis clavier pour VS Code.

Commands

De nombreuses QDK commandes pour écrire et exécuter des programmes Q# et OpenQASM sont disponibles uniquement lorsqu’un fichier .qs, .qasm ou .qsc est actif. D’autres commandes sont toujours disponibles.

Commandes générales

Command	Action	Remarques	Autre action de l’utilisateur
QDK: Créer un Q# projet	Crée un projet Q# dans le dossier actif, y compris un fichier manifeste qsharp.json et un sous-dossier src avec un fichier main.qs par défaut.	Pour plus d’informations sur Q# les projets, consultez Utilisation des Q# projets.	Dans l’Explorateur de fichiers, ouvrez le menu contextuel du dossier cible et sélectionnez Créer le projetQ#.
QDK: Créer un Microsoft Quantum carnet de notes	Ouvre un exemple Jupyter de notebook qui exécute un Q# programme + Python et envoie un travail à Azure Quantum.	Pour plus d’informations sur le QDK dans le notebook Jupyter, consultez Soumettre des travaux à Azure Quantum avec le package QDKPython.	N/A
QDK: Se connecter à un Azure Quantum espace de travail	Se connecte à un Azure Quantum espace de travail à l’aide de votre compte Azure ou d’un chaîne de connexion. Une fois que vous êtes authentifié, sélectionnez l'icône Microsoft Quantum dans la barre d'activité.	Pour plus d’informations sur les connexions Azure Quantum, consultez Connexion à votre espace de travail Azure Quantum.	Pointez sur Quantum Workspaces et sélectionnez l’icône +.
QDK: Ouvrir QDK l’aire de jeux	Ouvre un dossier en ligne des programmes d’exemple de OpenQASM et de Q# dans l’Explorateur de fichiers. Modifiez et exécutez les programmes dans le simulateur quantique local, puis définissez des points d’arrêt et parcourez le code avec le débogueur intégré.	Pour plus d’informations, consultez le fichier README dans l’exemple de dossier.	N/A
QDK: Actualiser Azure Quantum les espaces de travail	Synchronise les dernières modifications de vos espaces de travail quantiques connectés.	En cas de problème de connexion, une icône d’alerte apparaît en regard du nom de l’espace de travail.	Pointez sur Les espaces de travail Quantum et sélectionnez l’icône d’actualisation.
QDK: Créer un Microsoft QuantumPython environnement virtuel	Crée un dossier et installe un environnement Python virtuel avec les packages sélectionnés.	Disponible dans l’application de bureau VS Code, mais pas VS Code pour le web.	N/A
QDK: sphère de Bloch	Ouvre le visualiseur de sphère Bloch.	Pour plus d’informations, consultez Comment utiliser le visualiseur de sphère de Bloch dans le QDK.	N/A
QDK: Afficher le journal des modifications	Ouvre un journal des modifications dans un nouvel onglet qui affiche QDK les mises à jour pour la version actuelle et toutes les versions précédentes.	Le journal des modifications est également disponible sur le référentiel GitHub open source QDKréférentiel GitHub.	N/A
Microsoft Quantum: Focus sur la vue Espaces de travail Quantum	Ouvre Microsoft Quantum la barre latérale et place le focus sur la vue Espaces de travail Quantum.	Si aucun espace de travail n’est connecté, la vue offre une option permettant de se connecter à un espace de travail existant. Pour plus d’informations, consultez Connexion à votre Azure Quantum espace de travail.	Sélectionnez l’icône Microsoft Quantum dans la barre d’activité, puis développez Quantum Workspaces.
Microsoft Quantum: Vue ciblée QDK Learning	Ouvre la Microsoft Quantum barre latérale et place le focus sur la vue QDK Learning d’accueil, où vous pouvez sélectionner Démarrer l’apprentissage.	Disponible dans le desktop VS Code avant d’initialiser QDK Learning dans l’espace de travail. Pour plus d'informations, voir Vue d'ensemble QDK Learning.	Sélectionnez l’icône Microsoft Quantum dans la barre d’activité, puis développez la section QDK Learning.
Microsoft Quantum: Focus sur la vue d’apprentissage	Ouvre la Microsoft Quantum barre latérale et place le focus sur la vue Formation, où vous pouvez accéder aux cours et poursuivre votre progression.	Disponible dans l’application de bureau VS Code après avoir initialisé QDK Learning dans l’espace de travail. Pour plus d'informations, voir Vue d'ensemble QDK Learning.	Sélectionnez l’icône Microsoft Quantum dans la barre d’activité, puis développez Learning.

Commandes disponibles en fonction du type de fichier actif

Command	Types de fichiers de programme	Action	Remarques	Autre action de l’utilisateur
QDK: Afficher le circuit	.qs, .qasm	Affiche un diagramme de circuit pour le programme avant son exécution.	Pour plus d’informations, consultez Visualiser les diagrammes de circuit quantique.	Sélectionnez l’option code lens Circuit dans le menu à côté de l’opération du point d’entrée ou au-dessus de chaque opération définie par l’utilisateur dans le programme.
QDK: Exécuter le fichier et afficher l’histogramme	.qs, .qasm	Exécute le programme actuel et affiche un histogramme des résultats dans un nouveau volet.	Pour accéder aux options de tri et de filtre, sélectionnez l’icône de filtre dans le volet histogramme.	Sélectionnez l'option code Lens Histogramme dans le menu en regard de l'opération de point d'entrée.
QDK: Télécharger QIR pour le QDK programme actuel	.qs, .qasm	Ouvre la QIR source du code Q# ou OpenQASM actuel dans une nouvelle fenêtre d’édition. Votre programme doit utiliser le profil cible Adaptive RIF, Adaptive RI ou QIR pour exporter la source Base.	Pour plus d’informations sur QIR, consultez la représentation intermédiaire Quantum et le blog du QDK développeur.	N/A
QDK: Calculer les estimations des ressources	.qs, .qasm	Exécute la version intégrée de l’estimateur de ressources. L’extension VS Code utilise une version obsolète de l’estimateur de ressource.	Pour plus d’informations, consultez Présentation de l’estimateur de Microsoft Quantum ressources.	N/A
QDK: Aide	.qs	Ouvre une brève vue d’ensemble de l’extension QDK dans VS Code.	N/A	N/A
QDK: Exécuter un fichier et afficher le diagramme de circuit	.qs, .qasm	Exécute le programme actuel et affiche un diagramme de circuit du programme avec des sorties.	Pour plus d’informations, consultez Visualiser les diagrammes de circuit quantique.	N/A
QDK: Afficher la documentation de l’API	.qs	Ouvre la documentation de l’API dans un nouveau volet. Pour rechercher dans ce volet, appuyez sur Ctrl+F.	Pour plus d’informations, consultez la Q#référence de l’API.	N/A
Déboguer : Démarrer le débogage	.qs, .qasm, .qsc	Ouvre le programme actuel dans le débogueur.	Pour plus d’informations, consultez Débogage et test de votre code quantique.	Appuyez sur F5, sélectionnez l’option Objectif de code Déboguer en regard de l’opération de point d’entrée, ou sélectionnez l’icône Exécuter dans le coin supérieur droit, puis sélectionnez Démarrer le débogage.
QDK: Exécuter le programme	.qs, .qasm, .qsc	Exécute le programme actuel dans le simulateur quantique par défaut.	Pour plus d’informations, consultez Bien démarrer avec les Q# programmes.	Appuyez sur Ctrl + F5, sélectionnez l’option CodeLens Exécuter à côté de l’opération du point d’entrée, ou sélectionnez l’icône Exécuter dans le coin supérieur droit, puis sélectionnez Exécuter.

Affichages du panneau

Q# et OpenQASM utilisent les vues suivantes dans le panneau VS Code :

View	Action
Console de débogage	Affiche la sortie d’exécution ou la sortie de débogage
Problèmes	Affiche les vérifications d’erreur de précompilation

Modifier le code Q# et OpenQASM

Les fonctionnalités d’édition de code les plus courantes dans VS Code sont également disponibles pour les programmes Q# et OpenQASM :

• Contrôles des erreurs de précompilation
• Accéder à la définition
• References
• Signatures de fonction
• Informations sur les paramètres
• Suggestions d’achèvement, notamment les saisies semi-contextuelles, les complétions des membres d’espace de noms et les complétions des membres de type
• Linting. Pour Q# les fichiers, configurez le linting par projet dans le fichier manifeste. Pour plus d’informations, consultez Utilisation des Q# projets.

Pour plus d’informations, consultez IntelliSense dans la VS Code documentation.

Tâches courantes

Les tableaux suivants répertorient les commandes pour les tâches courantes dans l’extension QDK .

Travailler avec des Q# fichiers et des projets

Tâche	Action	Remarques
Créer un nouveau fichier Q#	Sélectionnez Fichier > Nouveau fichier texte>. Enregistrez le fichier avec une extension .qs.	Si vous définissez Files: Default Language = qsharp, les nouveaux fichiers sont automatiquement au format Q# par défaut.
Créer un Q# projet	Dans un dossier ouvert dans l’Explorateur de fichiers, sélectionnez QDK: Créer un Q# projet à partir de la palette de commandes. Vous pouvez également ouvrir le menu contextuel du dossier dans l’Explorateur de fichiers, puis sélectionner Créer Q# un projet.	Pour plus d’informations sur Q# les projets, consultez Utilisation des Q# projets.
Créer un exemple de fichier	Dans un fichier .qasmvide.qs, entrez des exemples, puis sélectionnez un programme d’exemple dans la liste.	Vous pouvez également sélectionner QDK: Ouvrir QDK playground dans la palette de commandes pour ouvrir un dossier en ligne de OpenQASM et Q# programmes d’exemple dans l’Explorateur de fichiers.

Se connecter à Azure Quantum

Tâche	Action	Remarques	Autre action de l’utilisateur
Se connecter à un Azure Quantum espace de travail	Sélectionnez l’icône Microsoft Quantum dans la barre d’activité. Dans Quantum Workspaces, sélectionnez Se connecter à un espace de travail existant. Suivez les instructions pour sélectionner un abonnement et un espace de travail.	Vous pouvez vous connecter à plusieurs espaces de travail. Sélectionnez + à côté de Quantum Workspaces pour connecter un autre espace de travail. Les connexions d’espace de travail persistent entre vos VS Code sessions.	Dans la palette de commandes, sélectionnez QDK: Se connecter à un Azure Quantum espace de travail.
Se connecter de manière programmatique à l’aide d’un Python programme	Ouvrez le menu contextuel d’une connexion d’espace de travail existante et sélectionnez Copier Python le code de connexion à l’espace de travail. Collez le code résultant dans votre Python programme.	Pour plus d’informations, consultez Envoyer des travaux vers Azure Quantum avec le QDKPython package.	N/A

Exécuter des programmes

Tâche	Action	Remarques	Autre action de l’utilisateur
Exécuter un Q# ou OpenQASM programme sur le simulateur quantique local	Dans un fichier .qasm ou .qs, sélectionnez l’icône Exécuter dans le coin supérieur droit, puis sélectionnez Exécuter.	Pour plus d’informations sur le simulateur quantique, consultez le simulateur quantique épars.	Appuyez sur Ctrl + F5, ou choisissez QDK: Exécuter le fichier et afficher l’histogramme ou QDK: Exécuter le fichier et afficher le diagramme de circuit dans la palette de commandes, ou choisissez l’option CodeLens Exécuter au-dessus de l’opération de point d’entrée.
Déboguer un programme	Dans un programme Q# ou OpenQASM, sélectionnez l’icône Exécuter dans le coin supérieur droit, puis sélectionnez Démarrer le débogage.	Pour plus d’informations sur le débogueur Q# dans VS Code, consultez Débogage et test de votre code quantique.	Appuyez sur F5 ou choisissez le filtre de code Débogage de code dans le menu au-dessus de l’opération de point d’entrée.
Afficher les fournisseurs et les cibles dans vos espaces de travail	Sélectionnez l’icône Microsoft Quantum dans la barre d’activité. À partir des espaces de travail Quantum, développez l’espace de travail, puis développez Fournisseurs pour afficher les fournisseurs disponibles dans l’espace de travail. Développez un fournisseur individuel pour afficher les cibles accessibles.	Pointez sur un nom de cible pour afficher son statut et son temps d’attente dans la file d’attente avant de soumettre un emploi.	N/A
Envoyer une tâche à Azure Quantum	Avec un programme OpenQASM ou Q# ouvert, sélectionnez un espace de travail, un fournisseur et une cible. Pour envoyer le programme actuel, sélectionnez la flèche en regard de la cible.	Pour plus d’informations, consultez Envoyer des travaux vers Azure Quantum avec l’extension QDK pour VS Code.	N/A
Afficher les résultats du travail	Développez l’espace de travail, puis développez Jobs. Pour ouvrir le résultat du travail depuis stockage Azure, cliquez sur l’icône cloud à côté du nom du travail.	Les travaux sont répertoriés du plus récent au plus ancien.	N/A