Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

Création d’un problème

Les problèmes peuvent être créés de différentes façons. Vous pouvez donc choisir la méthode la plus pratique pour votre workflow.

Qui peut utiliser cette fonctionnalité

People with read access can create an issue in a repository where issues are enabled.

Les problèmes peuvent être utilisés pour suivre les bogues, les améliorations ou d’autres demandes. Pour plus d’informations, consultez « À propos des problèmes ».

Les administrateurs de dépôt peuvent désactiver les problèmes liés à un dépôt. Pour plus d’informations, consultez « Désactivation des problèmes ».

Création d’un problème à partir d’un dépôt

  1. Dans GitHub.com, accédez à la page principale du dépôt. 2. Sous le nom de votre dépôt, cliquez sur Problèmes. Onglet Problèmes 1. Cliquez sur Nouveau problème. Bouton Nouveau problème
  2. Si votre dépôt utilise des modèles de problème, cliquez sur Démarrage à côté du type de problème que vous souhaitez ouvrir. Sélectionnez le type de problème que vous souhaitez créer ou cliquez sur Ouvrir un problème vide si le type de problème que vous souhaitez ouvrir ne figure pas dans les options disponibles. Lien pour ouvrir un problème vide 1. Tapez un titre et une description pour votre problème. Exemple de problème 1. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un tableau de projet, l’associer à un jalon ou appliquer une étiquette. 1. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème avec GitHub CLI

GitHub CLI est un outil open source permettant d’utiliser GitHub à partir de la ligne de commande de votre ordinateur. Lorsque vous travaillez à partir de la ligne de commande, vous pouvez utiliser l’GitHub CLI pour gagner du temps et éviter de changer de contexte. Pour en savoir plus sur GitHub CLI, consultez « À propos de GitHub CLI ».

Pour créer un problème, utilisez la sous-commande gh issue create. Pour ignorer les invites interactives, incluez les indicateurs --body et --title.

gh issue create --title "My new issue" --body "Here are more details."

Vous pouvez également spécifier des destinataires, des étiquettes, des jalons et des projets.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Création d’un problème à partir d’un commentaire

Vous pouvez ouvrir un nouveau problème à partir d’un commentaire dans un problème ou une demande de tirage. Quand vous ouvrez un problème à partir d’un commentaire, le problème contient un extrait de code indiquant où le commentaire a été initialement publié.

  1. Accédez au commentaire à partir duquel vous souhaitez ouvrir un problème.
  2. Dans ce commentaire, cliquez sur . Bouton Kebab dans le commentaire de revue de la demande de tirage
  3. Cliquez sur Référence dans un nouveau problème. Élément de menu Référence dans un nouveau problème
  4. Utilisez le menu déroulant « Dépôt » et sélectionnez le dépôt dans lequel vous souhaitez ouvrir le problème. Liste déroulante du dépôt pour un nouveau problème
  5. Tapez un titre et un corps descriptifs pour le problème. Titre et corps du nouveau problème
  6. Cliquez sur Créer un problème. Bouton pour créer un problème 1. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un tableau de projet, l’associer à un jalon ou appliquer une étiquette. 1. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir du code

Vous pouvez ouvrir un nouveau problème à partir d’une ou plusieurs lignes de code spécifiques dans un fichier ou une demande de tirage. Quand vous ouvrez un problème à partir du code, le problème contient un extrait indiquant la ligne ou la plage de code que vous avez choisie. Vous ne pouvez ouvrir un problème que dans le même dépôt où le code est stocké.

Extrait de code rendu dans un problème ouvert à partir du code

  1. Dans GitHub.com, accédez à la page principale du dépôt.
  2. Localisez le code que vous souhaitez référencer dans un problème :
    • Pour ouvrir un problème concernant du code dans un fichier, accédez au fichier.
    • Pour ouvrir un problème concernant du code dans une demande de tirage, accédez à celle-ci, puis cliquez sur Fichiers modifiés. Ensuite, accédez au fichier contenant le code que vous souhaitez inclure dans votre commentaire, puis cliquez sur Afficher.
  3. Choisissez de sélectionner une seule ligne ou une plage :
    • Pour sélectionner une seule ligne de code, cliquez sur le numéro de la ligne pour mettre celle-ci en surbrillance. Fichier avec une seule ligne de code sélectionnée
      • Pour sélectionner une plage de code, cliquez sur le numéro de la première ligne de code de la plage pour mettre celle-ci en surbrillance. Pointez ensuite sur la dernière ligne de la plage de code, appuyez sur Maj et cliquez sur le numéro de la ligne pour mettre la plage en surbrillance. Fichier avec une plage de code sélectionnée
  4. À gauche de la plage de code, cliquez sur . Dans le menu déroulant, cliquez sur Référencer dans le nouveau problème. Menu Kebab avec option permettant d’ouvrir un nouveau problème à partir d’une ligne sélectionnée 1. Tapez un titre et une description pour votre problème. Exemple de problème 1. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un tableau de projet, l’associer à un jalon ou appliquer une étiquette. 1. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir d’une discussion

Les personnes disposant d’une autorisation de triage sur un dépôt peuvent créer un problème à partir d’une discussion.

Quand vous créez un problème à partir d’une discussion, le contenu du billet de discussion est automatiquement inclus dans le corps du problème et toutes les étiquettes sont conservées. La création d’un problème à partir d’une discussion ne convertit pas la discussion en problème et ne supprime pas la discussion existante. Pour plus d’informations sur GitHub Discussions, consultez « À propos des discussions ».

  1. Sous votre dépôt ou nom d’organisation, cliquez sur Discussions. Onglet « Discussions » d’un dépôt 1. Dans la liste des discussions, cliquez sur la discussion à afficher. Discussion dans la liste de discussions d’un dépôt
  2. Dans la barre latérale droite, cliquez sur Créer un problème à partir d’une discussion. Bouton pour créer un problème à partir de la discussion 1. Tapez un titre et une description pour votre problème. Exemple de problème 1. Si vous êtes mainteneur de projet, vous pouvez affecter le problème à une personne, l’ajouter à un tableau de projet, l’associer à un jalon ou appliquer une étiquette. 1. Lorsque vous avez terminé, cliquez sur Envoyer le nouveau problème.

Création d’un problème à partir d’un projet

Vous pouvez rapidement créer des problèmes sans quitter votre projet. Lors de l’utilisation d’une vue groupée par un champ, la création d’un problème dans ce groupe définit automatiquement le champ du nouveau problème sur la valeur du groupe. Par exemple, si vous regroupez votre vue par « Statut », lorsque vous créez un problème dans le groupe « À faire », le « Statut » du nouveau problème est automatiquement défini sur « À faire ». Pour plus d’informations sur les projets, consultez « À propos des projets ».

  1. Accédez à votre projet.

  2. En bas d’un tableau, d’un groupe d’éléments ou d’une colonne dans la disposition de tableau, cliquez sur .

    Capture d’écran montrant le bouton + en bas du projet

  3. Cliquez sur Créer un problème.

    Capture d’écran montrant l’élément de menu « Créer un problème »

  4. En haut de la boîte de dialogue « Créer un problème », sélectionnez le dépôt dans lequel vous souhaitez créer le nouveau problème.

    Capture d’écran montrant le menu déroulant des dépôts

  5. Sous le menu déroulant des dépôts, tapez un titre pour le nouveau problème.

    Capture d’écran montrant le champ du titre du problème

  6. Si vous le souhaitez, utilisez les champs situés sous le champ de titre pour définir les destinataires, les étiquettes et les jalons, et ajoutez le nouveau problème à d’autres projets.

    Capture d’écran montrant les options de destinataire, d’étiquette, de projet et de jalon

  7. Si vous le souhaitez, tapez une description de votre problème.

    Capture d’écran montrant le champ de description

  8. Si vous voulez éventuellement créer d’autres problèmes, sélectionnez Créer plus et la boîte de dialogue se rouvrira quand vous créerez votre nouveau problème.

    Capture d’écran montrant la case à cocher Créer plus

  9. Cliquez sur Créer.

    Capture d’écran montrant le bouton Créer

Création d’un problème à partir d’une note de classic project

Si vous utilisez un classic project pour suivre et hiérarchiser votre travail, vous pouvez convertir les notes en problèmes. Pour plus d’informations, consultez « À propos des projects (classic) » et « Ajout de notes à un classic project ».

Création d’un problème à partir d’un élément de liste de tâches

Dans un problème, vous pouvez utiliser des listes de tâches pour diviser le travail en tâches plus petites et suivre l’ensemble du travail jusqu’à sa complétion. Si une tâche nécessite une discussion ou un suivi plus approfondi, vous pouvez convertir la tâche en problème en pointant sur la tâche et en cliquant sur dans le coin supérieur droit de la tâche. Pour plus d’informations, consultez « À propos des listes de tâches ».

Création d’un problème à partir d’une requête d’URL

Vous pouvez utiliser des paramètres de requête pour ouvrir des problèmes. Les paramètres de requête sont des éléments facultatifs d’URL que vous pouvez personnaliser pour partager une vue de page web spécifique, comme des résultats de filtre de recherche ou un modèle de problème sur GitHub. Pour créer vos propres paramètres de requête, vous devez faire correspondre la paire clé-valeur.

Astuce : Vous pouvez également créer des modèles de problème qui s’ouvrent avec des étiquettes, des destinataires et un titre de problème par défaut. Pour plus d’informations, consultez « Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles ».

Vous devez disposer des autorisations appropriées pour chaque action dont vous voulez utiliser le paramètre de requête équivalent. Par exemple, vous devez avoir l’autorisation d’ajouter une étiquette à un problème pour utiliser le paramètre de requête labels. Pour plus d’informations, consultez « Rôles de dépôt pour une organisation ».

Si vous créez une URL non valide avec des paramètres de requête, ou si vous n’avez pas les autorisations appropriées, l’URL renvoie une page d’erreur 404 Not Found. Si vous créez une URL qui dépasse la limite du serveur, l’URL retourne une page d’erreur 414 URI Too Long.

Paramètre de requête.Exemple
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report crée un problème avec l’étiquette « bug » et le titre « New bug report ».
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. crée un problème avec le titre « New bug report » et le commentaire « Describe the problem » dans le corps du problème.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug crée un problème avec les étiquettes « help wanted » et « bug ».
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones crée un problème avec le jalon « testing milestones ».
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat crée un problème et l’affecte à @octocat.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 crée un problème avec le titre « Bug fix » et l’ajoute au tableau de projet 1 de l’organisation.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md crée un problème avec un modèle dans le corps du problème. Le paramètre de requête template fonctionne avec des modèles stockés dans un sous-répertoire ISSUE_TEMPLATE dans le répertoire racine, docs/ ou .github/ d’un dépôt. Pour plus d’informations, consultez « Utilisation de modèles pour encourager les problèmes et demandes de tirage utiles ».

Vous pouvez également utiliser des paramètres de requête d’URL pour remplir les champs de texte personnalisés que vous avez définis dans les modèles de formulaires de problème. Les paramètres de requête pour les champs de formulaire de problème peuvent également être passés au sélecteur de modèle de problème. Pour plus d’informations, consultez « Syntaxe du schéma de formulaire de GitHub ».

Création d’un problème à partir d’une alerte code scanning

Remarque : Le suivi des alertes d’code scanning dans les problèmes est en version bêta et peut être amené à changer.

Cette fonctionnalité prend en charge l’exécution d’analyses de manière native via GitHub Actions ou de manière externe via l’infrastructure CI/CD existante ainsi que les outils d’code scanning tiers, mais pas à l’aide d’outils de suivi tiers.

Si vous utilisez des problèmes pour suivre et hiérarchiser votre travail, vous pouvez utiliser des problèmes pour suivre les alertes code scanning. Pour plus d’informations sur la création de problèmes pour suivre les alertes d’code scanning, consultez « [Suivi des alertes d’code scanning dans les problèmes à l’aide de listes de tâches](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists) ».

Pour aller plus loin