Si un point d'arrêt se transforme en cercle gris vide dans VS Code sur votre Mac, le débogueur n'a pas pu l'enregistrer. Commencez par vérifier si la ligne peut s'exécuter et si le débogueur actif prend en charge ce fichier. Vérifiez ensuite que la session de débogage exécute bien le code que vous êtes en train d'éditer. Cet indicateur ne permet pas à lui seul d'identifier la cause exacte ; cette séquence permet de la cerner sans faire de suppositions hasardeuses sur un correctif universel. Le guide de débogage de VS Code décrit le cercle vide et ses causes courantes.

Confirmer l'état du point d'arrêt affiché

Un cercle rouge plein correspond à un point d'arrêt activé ; un cercle gris plein est désactivé. Un cercle gris vide signifie que le débogueur n'a pas pu enregistrer le point d'arrêt. La documentation de VS Code mentionne deux raisons courantes : la ligne ne contient aucun code exécutable, ou le débogueur ne prend pas en charge ce fichier source. Les points d'arrêt qui ne peuvent pas être enregistrés peuvent également apparaître vides au démarrage d'une session ; des modifications du code source au cours d'une session sans prise en charge de l'édition en direct peuvent entraîner l'apparition du même indicateur. Le comportement exact peut varier en fonction du langage et de l'extension du débogueur.

Sur macOS, ouvrez Exécuter et déboguer avec Maj–Commande–D. Dans sa section POINTS D'ARRÊT, repérez l'entrée concernée et vérifiez qu'elle est activée. Cette vue vous permet de gérer les points d'arrêt, mais elle n'explique pas à elle seule pourquoi un débogueur en a rejeté un. Gardez l'éditeur ouvert sur la ligne marquée afin de pouvoir comparer l'emplacement source avec le fichier utilisé par votre session. VS Code: Debug code

Vérifier si la ligne peut s'exécuter

Déplacez le point d'arrêt vers une ligne qui effectue une action, comme une instruction à l'intérieur d'une fonction, plutôt qu'une ligne vide, un commentaire ou une accolade. Un point d'arrêt n'est utile que là où le débogueur peut interrompre l'exécution. Si le marqueur de remplacement devient un cercle rouge plein après le démarrage de la session, la ligne d'origine ne contenait probablement aucun code exécutable. Il s'agit d'une déduction diagnostique tirée du comportement documenté, et non d'une certitude : la prise en charge et la liaison des points d'arrêt dépendent du débogueur et du langage.

Si le code est généré, transcompilé, regroupé (bundled) ou s'il diffère d'une manière ou d'une autre du fichier exécuté par le programme en cours d'exécution, le débogueur peut nécessiter des source maps ou une autre configuration spécifique au langage pour relier l'emplacement dans l'éditeur au code d'exécution. Le guide général de VS Code ne prescrit pas de configuration universelle pour cette situation. Consultez la documentation de l'extension de débogueur et de la configuration de build que vous utilisez avant de modifier les paramètres de mappage.

Vérifier le débogueur actif et la session

VS Code inclut la prise en charge native du débogage pour JavaScript, TypeScript et Node.js. Les autres langages et environnements d'exécution nécessitent généralement une extension de débogueur appropriée. Vérifiez que l'extension correspondante est installée et active, puis démarrez une session pour le langage ou le runtime associé. Si VS Code vous invite à sélectionner un débogueur, choisissez celui qui correspond au programme que vous souhaitez exécuter. La documentation d'une extension définit les fichiers sources pris en charge, le comportement des points d'arrêt et les options de lancement. VS Code: Debug code

Appuyez sur F5 pour démarrer le débogage, ou utilisez Exécuter et déboguer pour sélectionner une configuration. Un programme simple peut s'exécuter à partir du fichier actif, mais une application avec un point d'entrée spécifique, des arguments, des variables d'environnement ou une cible d'attachement peut nécessiter une configuration launch.json. Pour une configuration d'attachement, assurez-vous que le processus cible s'exécute déjà en mode débogage et que les paramètres de connexion correspondent. Un point d'arrêt correctement placé dans un fichier différent de la source chargée par le programme peut rester non vérifié. VS Code: Configure debugging

Réduire les causes possibles avec une séquence courte

Suivez cet ordre en ne modifiant qu'une chose à la fois afin d'obtenir un résultat probant :

  1. Dans POINTS D'ARRÊT, vérifiez que le point d'arrêt est activé et notez son fichier et sa ligne.
  2. Déplacez-le sur une instruction exécutable dans ce fichier.
  3. Démarrez la configuration de débogage voulue avec F5 et vérifiez si le marqueur s'enregistre.
  4. S'il reste vide, vérifiez que le débogueur sélectionné prend en charge le fichier et que son extension est installée et active.
  5. Vérifiez que la configuration lance ou s'attache bien au programme compilé à partir de la source que vous consultez. Vérifiez son point d'entrée, son répertoire de travail et toute tâche de build ou de pré-lancement pertinente pour votre projet.
  6. Si l'application transforme le code source, consultez les instructions du débogueur du langage pour faire correspondre les fichiers de l'éditeur au code d'exécution.

Une vérification réussie ne prouve pas que chaque point d'arrêt d'un projet est valide ; répétez la vérification pour l'emplacement source particulier concerné. Si le débogueur signale une erreur de configuration ou d'enregistrement, utilisez ce message et la documentation de l'extension pour guider la modification suivante. Évitez de copier des paramètres prévus pour un autre débogueur : VS Code précise que les propriétés et les capacités de configuration dépendent du débogueur sélectionné et du type de requête. VS Code: Configure debugging

Ce que l'indicateur peut et ne peut pas vous apprendre

Le cercle vide vous indique que le débogueur n'a pas enregistré ce point d'arrêt. Il ne peut pas, à lui seul, distinguer une ligne non exécutable d'une source non prise en charge, d'une discordance entre l'éditeur et le code d'exécution, ou d'autres limites propres au débogueur. L'étape suivante la plus utile consiste à tester une ligne clairement exécutable dans la session prévue, puis à vérifier le débogueur et le mappage des sources si l'enregistrement échoue toujours. Sur Mac, les commandes principales restent les mêmes : la marge de l'éditeur VS Code, la vue Exécuter et déboguer, F5 et Maj–Commande–D ; les correctifs spécifiques à chaque débogueur doivent provenir de la documentation de l'extension ou du runtime.

Sources