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 (VS) Code, ainsi que des fonctionnalités spécifiques à Q#lors de l’utilisation de fichiers .qs. Cet article est un guide de référence pour toutes les commandes et fonctionnalités associées À Q#, avec des liens vers du contenu supplémentaire si nécessaire. Pour obtenir des conseils généraux sur VS Code, consultez la documentation VS Code.
Conseil
La plupart des commandes associées à Q# sont accessibles à partir du menu Afficher > la palette de commandes. Dans un fichier .qs, sélectionnez Ctrl-Maj-P (Cmd-Maj-P sur macOS) et entrez Q# pour afficher une liste filtrée de commandes.
Pour tous les raccourcis clavier macOS, consultez raccourcis clavier pour macOS.
Commandes
La plupart des commandes associées à Q# sont accessibles à partir du menu Afficher > la palette de commandes. Sélectionnez Ctrl-Maj-P et entrez Q# pour afficher une liste filtrée de commandes. Certaines commandes sont disponibles uniquement lorsqu’un fichier .qs est actif.
Conseil
Vous pouvez créer des raccourcis clavier personnalisés pour n’importe quelle commande VS Code à l’aide de raccourcis clavier ou de Ctrl+K+S. Pour plus d’informations, consultez Liaisons de clés pour VS Code.
| Commande | Action | Notes | Autre action de l’utilisateur |
|---|---|---|---|
| Q# : Créer un projet Q# | Crée un projet Q# dans le dossier actif, notamment : * un fichier manifeste qsharp.json * sous-dossier src avec un fichier main.qs par défaut. |
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#. |
| Q# : 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 |
| Q# : 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 Explorateur de fichiers, pointez sur les espaces de travail Quantum et sélectionnez l’icône « + ». |
| Q# : Ouvrir le terrain de jeu Q# | 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 |
| Q# : 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 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 fichier .qs est actif.
| Commande | Action | Notes | Autre action de l’utilisateur |
|---|---|---|---|
| Q# : Définir le profil cible QIR Azure Quantum | Définit le QIR ou la représentation intermédiaire quantique, profil cible pour vos programmes Q#. | Pour plus d’informations sur les profils cibles, consultez Profils cibles. | Le profil cible actuel s’affiche dans la barre d’outils inférieure. Sélectionnez le profil cible dans la barre d’outils pour ouvrir la liste déroulante de sélection. |
| Q# : 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. |
| Q# : Exécuter le fichier et afficher l’histogramme | Exécute le programme Q# actuel et affiche un histogramme des résultats dans le volet droit. | 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. |
| Q# : Obtenir QIR pour le programme Q# 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 ou ri adaptatif 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 |
| Déboguer : Fichier Q# de débogage | Ouvre le programme Q# actuel dans le débogueur. | Pour plus d’informations, consultez Débogage et test de votre code quantique. | * Sélectionner F5 * Sélectionnez l’option Objectif de code Déboguer dans le menu en regard de l’opération de point d’entrée. * Sélectionnez l’icône Exécuter en haut à droite, puis sélectionnez Déboguer le fichier Q#. |
| Déboguer : Exécuter le fichier Q# | 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#. | * Sélectionner Ctrl+F5 * Sélectionnez l’option d’objectif de code Exécuter dans le menu en regard de l’opération de point d’entrée. * Sélectionnez l’icône Exécuter en haut à droite, puis sélectionnez Exécuter le fichier Q#. |
| Q# : 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 |
| Q# : 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 |
| Q# : 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 |
| Q# : Afficher la documentation de l’API | Ouvre la documentation de l’API dans un nouveau volet. Recherchez ce volet à l’aide de Ctrl-F. | Pour plus d’informations, consultez la référence de l’API Azure Quantum. | S/O |
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 |
Modification du code Q#
La plupart des fonctionnalités courantes de modification de code dans VS Code sont disponibles lors de l’utilisation des programmes Q#. Pour plus d’informations, consultez IntelliSense dans la documentation VS Code.
- 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 d’achèvement
- Linting : dans les fichiers Q#, vous configurez le linting par projet dans le fichier manifeste. Pour plus d’informations, consultez Utilisation des projets Q#.
Tâches courantes
Utilisation de fichiers et de projets Q#
| Tâche | Action | Notes |
|---|---|---|
| Nouveau fichier Q# | Sélectionnez Fichier > Nouveau fichier texte>. Enregistrez le fichier avec une extension .qs. | Si vous définissez Files: Default Language = qsharp, un nouveau fichier est automatiquement mis 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 .qs vide, entrez des exemples, puis sélectionnez un exemple de programme dans la liste. | Vous pouvez également sélectionner Ouvrir le terrain de jeu Q# dans la palette de commandes pour ouvrir un dossier en ligne d’exemples de programmes Q# dans Explorateur de fichiers. |
Connexion à Azure Quantum
| Tâche | Action | Notes | Autre action de l’utilisateur |
|---|---|---|---|
| Se connecter à un espace de travail Azure Quantum | Dans Explorateur de fichiers, développez les 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 « + » en regard des espaces de travail Quantum pour connecter un autre espace de travail. Les connexions d’espace de travail persistent entre vos sessions VS Code. * Pour supprimer une connexion d’espace de travail, cliquez avec le bouton droit sur l’espace de travail, puis sélectionnez Supprimer la connexion de l’espace de travail. |
Dans la palette de commandes, sélectionnez 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écution de 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 le fichier Q#. | Pour plus d’informations sur le simulateur quantique, consultez le simulateur quantique partiellement alloué. | * Sélectionner Ctrl-F5 * Dans la palette de commandes, sélectionnez Q# : Exécuter un fichier et afficher l’histogramme ou Q# : Exécuter le fichier et afficher le diagramme de circuit * Sélectionnez l’option d’objectif de code Exécuter dans le menu en regard 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 sélectionnez Déboguer le fichier Q#. | Pour plus d’informations sur le débogueur Q# dans VS Code, consultez Débogage et test de votre code quantique. | * Sélectionner F5 * Sélectionnez l’option Objectif de code Déboguer dans le menu en regard de l’opération de point d’entrée. |
| Afficher les fournisseurs et les cibles dans vos espaces de travail | Dans 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. | Remarque : placez le curseur sur un nom cible pour afficher son heure d’état et de file d’attente avant d’envoyer un travail. | 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 avec le plus récent en haut. | N/A |