Résolution d’un blocage sur votre requête pull

          GitHub Code Quality est actuellement en préversion publique et sera disponible de façon générale le 20 juillet 2026.

Pendant préversion publique, Code Quality ne sera pas facturé, bien que les analyses Code Quality consomment des minutes GitHub Actions. À partir du 20 juillet 2026, l’utilisation entraîne des frais. Consultez « GitHub Code Quality Facturation ».

Comprendre pourquoi votre requête de pull est bloquée

Les administrateurs du dépôt peuvent définir des critères de qualité à l’aide de GitHub Code Quality. Lorsque vous ouvrez une pull request, des vérifications sont automatiquement exécutées afin d’évaluer si vos modifications respectent ces normes.

Il existe deux types de blocs :

• Résultats de la qualité du code : vos modifications introduisent des problèmes inférieurs au seuil de qualité requis.
• Seuil de couverture : vos modifications font passer la couverture du code en dessous du minimum requis, ou la font diminuer de plus que la limite autorisée par rapport à la branche par défaut.

Si votre demande de tirage introduit du code qui tombe en dessous du seuil de qualité requis, vous verrez une bannière de bloc de fusion en bas de la demande de tirage dans la section « Vérifications » : « La fusion est bloquée : les résultats de la qualité du code ont été détectés ».

Ces vérifications permettent de maintenir une base de code saine et gérable et d’empêcher l’accumulation de dettes techniques.

Affichage des résultats de l’analyse et de leurs niveaux de gravité

Les résultats de l’analyse sont présentés sous forme de commentaires sur votre requête pull, laissés par le github-code-quality[bot]. Chaque commentaire correspond à un problème de qualité de code spécifique détecté dans vos modifications.

Les commentaires sont étiquetés par gravité (Erreur, Avertissement, Remarque). Pour en savoir plus sur ce que signifient les niveaux de gravité, consultez Niveaux de gravité.

Déterminer quels constats bloquent votre pull request

La porte de qualité définie par les administrateurs de référentiel définit le niveau de gravité minimal qui bloquera la fusion.

La bannière de bloc de fusion peut spécifier le niveau de gravité minimal. Toutes les constatations à ce niveau de gravité ou supérieur doivent être traitées avant de pouvoir fusionner votre requête pull.

Correction ou rejet de chaque recherche

Pour débloquer votre pull request, vous devez résoudre chaque problème identifié en déterminant s’il faut résoudre le problème dans votre code ou ignorer le commentaire.

Tirer parti de Copilot correction automatique et Agent cloud Copilot pour corriger les découvertes

Copilot correction automatique

Les commentaires sur le pull request incluent une autocorrection suggérée que vous pouvez commettre directement dans votre pull request. Examinez attentivement la correction automatique suggérée pour la logique, la sécurité et le style, puis cliquez sur Valider la suggestion.

Vous n’avez pas besoin d’une licence Copilot pour appliquer ces suggestions.

Agent cloud Copilot

Sinon, si vous disposez d’une Copilot licence, vous pouvez déléguer le travail de correction à Agent cloud Copilot. Commentez la pull request en mentionnant @Copilot et demandez à Copilot de corriger les problèmes détectés.

Copilot répond avec un émoji de yeux (👀) à votre commentaire, démarre une nouvelle session pour l'agent et ouvre un pull request avec les correctifs nécessaires.

Vous pouvez suivre Agent cloud Copilotle travail :

• Dans le pull request, le résumé est mis à jour à mesure de l'avancement du travail.
• À l’aide de la page des agents ou des journaux de session, consultez Gestion des sessions des agents.

Vous avez besoin d’une Copilot licence pour appeler Agent cloud Copilot.
S’inscrire Copilot

Rejeter le constat

Vous pouvez ignorer une recherche si elle n’est pas pertinente ou actionnable dans le contexte de votre codebase. Les raisons courantes d’ignorer une recherche sont les suivantes :

• La découverte se trouve dans le code ancien qui n’est plus maintenu.
• Il s’agit d’une exception connue des normes de codage de votre équipe.
• C’est un faux positif qui ne pose pas de risque de qualité réelle.

Si vous ignorez les alertes non pertinentes, vos vérifications de qualité se concentrent sur des problèmes significatifs.

Vérification que vous avez satisfait aux exigences

Pour voir si vous avez satisfait aux exigences de qualité du code, consultez la section « Vérifications » en bas de votre demande de tirage. La bannière de bloc de fusion ne doit plus être présente et vous devez être en mesure de fusionner vos modifications comme d’habitude.

Résoudre un blocage lié au seuil de couverture

Si votre pull request est bloquée par une règle de seuil de couverture, vous verrez dans la section « Checks » une bannière indiquant le blocage de la fusion, accompagnée d’un message précisant quel seuil n’a pas été atteint. Par exemple:

• « La couverture de 22,0 % est inférieure au minimum de 50,0 % » : la couverture de branches de votre branche de pull request est inférieure au pourcentage minimal de couverture configuré dans l’ensemble de règles.
• « La couverture a diminué de 2,5%, la baisse maximale autorisée est de 1,0%» : vos modifications ont entraîné la chute de la couverture par rapport au montant autorisé par rapport à la branche par défaut.

Pour débloquer votre pull request, vous devez ajouter ou modifier des tests afin qu’une plus grande partie de la base de code soit exécutée :

1. Consultez le commentaire récapitulatif de couverture sur votre pull request pour identifier les fichiers ou les zones insuffisamment couvertes.
2. Ajoutez ou mettez à jour des tests pour augmenter la couverture d’exécution.
3. Poussez vos modifications. La vérification de la couverture sera relancée automatiquement.

Étapes suivantes

Réduisez la dette technique en corrigeant les résultats dans les fichiers récemment modifiés. Consultez Amélioration de la qualité du code récemment fusionné avec l’IA.