Partager via

Référence : Extension du Kit de développement Azure Quantum pour Visual Studio Code

Le Kit de développement Azure Quantum (QDK) utilise toutes les fonctionnalités standard de Visual Studio Code (VS Code), ainsi que des fonctionnalités spécifiques à Q#lorsque vous travaillez avec des .qs fichiers. Ce guide de référence décrit toutes les commandes QDK auxquelles vous pouvez accéder dans la palette de commandes VS Code, ainsi que d’autres fonctionnalités et liens vers du contenu supplémentaire. Pour obtenir des conseils généraux sur VS Code, consultez la documentation VS Code.

Conseil

La plupart des commandes de l’extension QDK sont accessibles à partir du menu Afficher > la palette de commandes . Dans un .qs fichier, ouvrez la palette de commandes et entrez QDK : pour afficher une liste filtrée de commandes.

Commandes

La plupart des commandes QDK sont liées à l’écriture et à l’exécution de programmes Q# et sont disponibles uniquement lorsqu’un .qs fichier est actif. Les autres commandes fonctionnent en arrière-plan et ne sont pas accessibles dans la palette de commandes.

Le tableau suivant décrit les commandes de l’extension QDK qui apparaissent dans la palette de commandes.

Conseil

Vous pouvez créer des raccourcis clavier personnalisés pour les commandes VS Code à l’aide de raccourcis clavier, ou Ctrl + K + S. Pour plus d’informations, consultez Liaisons de clés pour VS Code.

Commande Action Notes Autre action de l’utilisateur
QDK : Créer un projet Q# Crée un projet Q# dans le dossier actif, y compris un qsharp.json fichier manifeste et un src sous-dossier avec un fichier par défaut main.qs . Pour plus d’informations sur les projets Q#, consultez Utilisation des projets Q#. Dans Explorateur de fichiers, cliquez avec le bouton droit sur le dossier cible et sélectionnez Créer un projet Q#.
QDK : Créer un notebook Azure Quantum Ouvre un exemple de notebook Jupyter qui exécute un programme Q# + Python et envoie un travail à Azure Quantum. Pour plus d’informations sur les notebooks Azure Quantum, consultez Utiliser des notebooks Azure Quantum. S/O
QDK : Se connecter à un espace de travail Azure Quantum Connectez-vous à un espace de travail Azure Quantum à l’aide de votre compte Azure ou d’un chaîne de connexion. Une fois que vous êtes authentifié, votre espace de travail apparaît dans Explorateur de fichiers dans les espaces de travail Quantum. Pour plus d’informations sur les connexions Azure Quantum, consultez Se connecter à votre espace de travail Azure Quantum. Dans l’Explorateur de fichiers, pointez sur les espaces de travail Quantum et sélectionnez l’icône + .
QDK : Ouvrir l'aire de jeu QDK Ouvre un dossier en ligne d’exemples de programmes Q# dans Explorateur de fichiers. Vous pouvez modifier et exécuter les programmes dans le simulateur quantique local, ainsi que définir des points d’arrêt et parcourir le code avec le débogueur intégré. Pour plus d’informations, consultez le fichier README dans l’exemple de dossier. S/O
QDK : Actualiser les espaces de travail Azure Quantum 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. Dans l’Explorateur de fichiers, pointez sur Les espaces de travail Quantum et sélectionnez l’icône d’actualisation.
Explorateur : Focus sur l’affichage Espaces de travail Quantum Ouvre Explorateur de fichiers et se concentre sur vos espaces de travail quantiques connectés, s’il est configuré. Si aucun espace de travail n’est configuré, vous êtes invité à ajouter un espace de travail existant. Pour plus d’informations sur les connexions Azure Quantum, consultez Se connecter à votre espace de travail Azure Quantum. S/O

Les commandes suivantes sont disponibles lorsqu’un .qs fichier est actif.

Commande Action Notes Autre action de l’utilisateur
QDK : Afficher le circuit Affiche un diagramme de circuit pour le programme Q# avant son exécution. Pour plus d’informations, consultez Visualiser les diagrammes de circuit quantique. Sélectionnez l’option De code lens Circuit dans le menu en regard de l’opération de 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 Exécute le programme Q# actuel et affiche un histogramme des résultats dans un nouveau volet. Pour accéder aux options de tri et de filtre de l’affichage de l’histogramme, sélectionnez l’icône de filtre dans le volet histogramme. Sélectionnez l’option De code lens Histogramme dans le menu en regard de l’opération de point d’entrée.
QDK : Obtenir QIR pour le programme QDK actuel Ouvre la source QIR pour le code Q# actuel dans une nouvelle fenêtre d’édition. Votre programme doit utiliser le profil cible Base, Ri adaptatif ou Adaptive RIF pour exporter la source QIR. Pour plus d’informations sur QIR, consultez la représentation intermédiaire Quantum et le blog du développeur Q#. S/O
QDK : Calculer les estimations des ressources Appelle la version intégrée de l’estimateur de ressources. Pour plus d’informations, consultez Présentation de l’estimateur de ressources Azure Quantum. S/O
QDK : Aide Vue d’ensemble de l’extension QDK dans VS Code. Pour obtenir la documentation complète d’Azure Quantum, consultez la documentation Azure Quantum. S/O
QDK : Exécuter un fichier et afficher le diagramme de circuit Exécute le programme Q# actuel et affiche un circuit du programme avec des sorties. Pour plus d’informations, consultez Visualiser les diagrammes de circuit quantique. S/O
QDK : Ajouter un fichier d’instructions Copilot pour Q# et OpenQASM Ouvre une invite qui vous donne la possibilité d’ajouter des instructions Copilot pour vous aider à écrire et exécuter du code Q# et OpenQASM. Pour plus d’informations, consultez Configurer le mode agent dans VS Code pour le Kit de développement Quantum. S/O
QDK : Afficher la documentation de l’API 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 référence de l’API Azure Quantum. S/O
QDK : Afficher le journal des modifications Ouvre un journal des modifications dans un nouvel onglet qui affiche les mises à jour QDK pour les versions actuelles et toutes les versions de version précédentes. Le journal des modifications est également disponible dans le référentiel GitHub QDK open source. S/O
Déboguer : Démarrer le débogage Ouvre le programme Q# actuel dans le débogueur. Pour plus d’informations, consultez Débogage et test de votre code quantique. Appuyez sur F5, ou sélectionnez l’option Objectif de code Déboguer dans le menu en regard de l’opération de point d’entrée, ou sélectionnez l’icône Exécuter en haut à droite, puis choisissez Démarrer le débogage.
Déboguer : Exécuter Exécute le programme Q# actuel dans le simulateur quantique par défaut. Pour plus d’informations, consultez Bien démarrer avec les programmes Q#. Appuyez sur Ctrl + F5, ou sélectionnez l'option Run de Code Lens dans le menu à côté de l'opération de point d'entrée, ou cliquez sur l'icône Exécuter en haut à droite, puis choisissez Exécuter.

Bornes

Les programmes Q# utilisent deux fenêtres de terminal dans VS Code :

Terminal 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écompiler

Modifier le code Q#

La plupart des fonctionnalités courantes de modification de code dans VS Code sont également disponibles lorsque vous utilisez des programmes Q# :

  • Vérification des erreurs de précompile
  • Définition de la page d’accueil
  • Références
  • Signatures de fonction
  • Informations sur les paramètres
  • Suggestions de saisie automatique, y compris les saisies automatiques sensibles au contexte, les membres d’espace de noms et les membres de type.
  • Linting : dans les fichiers Q#, vous configurez le linting par projet dans le fichier manifeste. Pour plus d’informations, consultez Utilisation des projets Q#.

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

Tâches courantes

Utiliser des fichiers et des projets Q#

Tâche Action Notes
Nouveau fichier Q# Sélectionnez Fichier > Nouveau fichier texte>. Enregistrez le fichier avec une .qs extension. Si vous définissez Files: Default Language = qsharp, un nouveau fichier est automatiquement défini par défaut sur la mise en forme Q#.
Créer un projet Q# Dans un dossier ouvert dans Explorateur de fichiers, sélectionnez Créer un projet Q# dans la palette de commandes, ou cliquez avec le bouton droit sur le dossier dans Explorateur de fichiers, puis sélectionnez Créer un projet Q#. Pour plus d’informations sur les projets Q#, consultez Utilisation des projets Q#.
Exemples de fichiers Dans un fichier vide .qs , entrez des exemples, puis sélectionnez un exemple de programme dans la liste des options. Vous pouvez également sélectionner Ouvrir le terrain de jeu QDK dans la palette de commandes pour ouvrir un dossier en ligne d’exemples de programmes Q# dans l’Explorateur de fichiers.

Se connecter à Azure Quantum

Tâche Action Notes Autre action de l’utilisateur
Se connecter à un espace de travail Azure Quantum Dans l’Explorateur de fichiers, développez Espaces de travail Quantum et sélectionnez Ajouter un espace de travail existant. Suivez les invites pour sélectionner un abonnement et un espace de travail. Vous pouvez vous connecter à plusieurs espaces de travail. Sélectionnez ＋ à côté de espaces de travail Quantum pour connecter un autre espace de travail. Les connexions d’espace de travail persistent entre vos sessions VS Code. Dans la palette de commandes, sélectionnez QDK : Se connecter à un espace de travail Azure Quantum.
Se connecter par programmation avec un programme Python Cliquez avec le bouton droit sur une connexion d’espace de travail existante, puis sélectionnez Copier le code Python pour vous connecter à l’espace de travail. Collez le code résultant dans votre programme Python. Pour plus d’informations, consultez Envoi de Python avec des travaux Q# à Azure Quantum. S/O

Exécuter des programmes

Tâche Action Notes Autre action de l’utilisateur
Exécuter un programme Q# sur le simulateur quantique local Dans un programme Q#, sélectionnez l’icône Exécuter en haut à droite, puis sélectionnez Exécuter. Pour plus d’informations sur le simulateur quantique, consultez le simulateur quantique partiellement alloué. 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 Exécuter l’objectif de code au-dessus de l’opération de point d’entrée.
Déboguer un programme Dans un programme Q#, sélectionnez l’icône Exécuter en haut à droite, puis choisissez 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 CodeLens Débogage 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 Dans l’Explorateur de fichiers, sélectionnez 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 disponibles. 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. S/O
Envoyer un travail à Azure Quantum Dans un programme Q#, sélectionnez un espace de travail, un fournisseur et une cible. Pour envoyer le programme Q# actuel, sélectionnez la flèche en regard de la cible. Pour plus d’informations, consultez Envoi de travaux Q# à Azure Quantum. S/O
Afficher les résultats du travail Développez l’espace de travail, puis développez Travaux. Pour ouvrir la sortie du travail à partir de Stockage Azure, sélectionnez l’icône cloud en regard du nom du travail. Les travaux sont répertoriés du plus récent au plus ancien. S/O
  • Last updated on