Skip to main content
Wir veröffentlichen regelmäßig Aktualisierungen unserer Dokumentation, und die Übersetzung dieser Seite ist möglicherweise noch nicht abgeschlossen. Aktuelle Informationen findest du in der englischsprachigen Dokumentation.

Einen Issue erstellen

Issues können auf verschiedene Arten erstellt werden, sodass du die bequemste Methode für deinen Workflow auswählen kannst.

Wer kann dieses Feature verwenden?

People with read access can create an issue in a repository where issues are enabled. Mitglieder in einem Unternehmen mit verwalteten Benutzer*innen können nur Änderungen in Repositorys vornehmen, die zu ihrem Unternehmen gehören.

Mit Issues kannst du Fehler, Verbesserungen oder andere Anforderungen nachverfolgen. Weitere Informationen findest du unter Informationen zu Issues.

Repositoryadministratoren können Issues für ein Repository deaktivieren. Weitere Informationen findest du unter Issues deaktivieren.

Erstellen eines Issues aus einem Repository

  1. Navigiere auf GitHub.com zur Hauptseite des Repositorys. 2. Klicke unter dem Namen deines Repositorys auf Issues. Registerkarte „Issues" 1. Klicke auf Neues Issue. Schaltfläche „Neues Issue“
  2. Wenn dein Repository Issuevorlagen verwendet, klicke neben dem Typ des Issues, das du öffnen möchtest, auf Erste Schritte. Wähle den Typ des zu erstellenden Issues aus oder klicke auf Leeres Issue öffnen, wenn der Typ des zu erstellenden Issues nicht in den verfügbaren Optionen enthalten ist. Link zum Öffnen eines leeren Issues 1. Gib einen Titel und eine Beschreibung für Deinen Issue ein. Ein Beispielissue 1. Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden. 1. Wenn du fertig bist, klicke auf Neues Issue übermitteln.

Erstellen eines Issues mit GitHub CLI

GitHub CLI ist ein Open-Source-Tool zur Verwendung von GitHub über die Befehlszeile deines Computers. Wenn du über die Befehlszeile arbeitest, kannst du die GitHub CLI verwenden, um Zeit zu sparen und Kontextwechsel zu vermeiden. Weitere Informationen zu GitHub CLI findest du unter Informationen zur GitHub CLI.

Führe zum Erstellen eines Issues den Unterbefehl gh issue create aus. Um die interaktiven Eingabeaufforderungen zu überspringen, musst du die Flags --body und --title einschließen.

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

Du kannst auch zugewiesene Personen, Bezeichnungen, Meilensteine und Projekte angeben.

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

Erstellen eines Issues aus einem Kommentar

Du kannst ein neues Issue aus einem Kommentar in einem Issue oder Pull Request öffnen. Wenn du einen Issue aus einem Kommentar öffnest, wird der Issue ein Ausschnitt enthalten, der zeigt, wo der Kommentar ursprünglich eingestellt wurde.

  1. Navigiere zu dem Kommentar, den du in ein Issue umwandeln möchtest.
  2. Klicke in diesem Kommentar auf das Symbol . Drei-Punkte-Menü im Reviewkommentar des Pull Request
  3. Klicke auf In neuem Issue darauf verweisen. Menüpunkt „In neuem Issue darauf verweisen“
  4. Verwende das Dropdownmenü „Repository" und wähle das Repository, in welchem du den Issue öffnen möchtest. Dropdownmenü „Repository“ für neue Issues
  5. Gib einen beschreibenden Titel und Text für den Issue ein. Titel und Text für neues Issue
  6. Klicke auf Issue erstellen. Schaltfläche zum Erstellen eines neuen Issues 1. Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden. 1. Wenn du fertig bist, klicke auf Neues Issue übermitteln.

Erstellen eines Issues aus Code

Du kannst neue Issues von einer bestimmten Codezeile oder über mehreren Codezeilen in einer Datei oder einem Pull Request öffnen. Wenn du einen Issue im Code öffnest, enthält der Issue einen Ausschnitt mit den ausgewählten Codezeilen. Du kannst einen Issue nur in dem Repository öffnen, in dem der Code gespeichert ist.

Code-Ausschnitt in einem Issue eingefügt, der im Code geöffnet wurde

  1. Navigiere auf GitHub.com zur Hauptseite des Repositorys.
  2. Suche den Code, auf den du in einem Issue verweisen möchtest:
    • Um einen Issue zu Code in einer Datei zu öffnen, navigiere zu dieser Datei.
    • Um ein Issue zu Code in einem Pull Request zu erstellen, musst du zu diesem Pull Request navigieren und auf  geänderte Dateien klicken. Navigiere anschließend zu der Datei mit dem Code, den dein Kommentar enthalten soll, und klicke auf Anzeigen.
  3. Wähle, ob eine einzelne Zeile oder ein Bereich ausgewählt werden soll:
    • Um eine einzelne Codezeile zu auszuwählen, klicke auf die Zeilennummer, um die Zeile hervorzuheben. Datei mit Auswahl einer einzelnen Codezeile
      • Klicke zum Auswählen eines Codebereichs auf die Zeilennummer der ersten Zeile im Bereich, um die Codezeile hervorzuheben. Bewege anschließend den Mauszeiger über die letzte Zeile im Codebereich, drücke die UMSCHALTTASTE, und klicke auf die Zeilennummer, um den Bereich hervorzuheben. Datei mit Auswahl eines Codebereichs
  4. Klicke links neben dem Codeabschnitt auf . Klicke im Dropdownmenü auf Im neuem Issue darauf verweisen. Drei-Punkte-Menü mit der Option, ein neues Issue für eine ausgewählte Zeile zu öffnen 1. Gib einen Titel und eine Beschreibung für Deinen Issue ein. Ein Beispielissue 1. Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden. 1. Wenn du fertig bist, klicke auf Neues Issue übermitteln.

Erstellen eines Issues aus Diskussion

Personen mit Selektierungsberechtigung für ein Repository können Issues aus Diskussionen erstellen.

Wenn du ein Issue aus einer Diskussion erstellst, wird der Diskussionsinhalt automatisch in den Issuetext aufgenommen, und alle Bezeichnungen werden aufbewahrt. Durch das Erstellen eines Issues aus einer Diskussion wird die Diskussion weder in ein Issue umgewandelt noch wird die bestehende Diskussion gelöscht. Weitere Informationen zu GitHub Discussions findest du unter Informationen zu Diskussionen.

  1. Klicke unter deinem Repository- oder Organisationsnamen auf Diskussionen.

    Screenshot der Registerkarten in einem GitHub-Repository. Die Option „Diskussionen“ ist in dunklem Orange eingerahmt. 1. Klicke in der Liste der Diskussionen auf die Diskussion, die du anzeigen möchtest.

  2. Klicke in der rechten Randleiste auf  Issue aus Diskussion erstellen.

    Screenshot der Randleiste in einer Diskussion. Die Option „Issue aus Diskussion erstellen“ ist dunkelorange umrandet.

  3. Gib einen Titel und eine Beschreibung für Deinen Issue ein. Ein Beispielissue 1. Wenn du Projektbetreuer*in bist, kannst du das Issue jemandem zuweisen, es einem Projektboard hinzufügen, ihm einen Meilenstein zuordnen oder eine Bezeichnung anwenden. 1. Wenn du fertig bist, klicke auf Neues Issue übermitteln.

Erstellen eines Issues über ein Projekt

Du kannst schnell Issues erstellen, ohne dein Projekt zu verlassen. Wenn du eine Ansicht verwendest, die nach einem Feld gruppiert ist, wird beim Erstellen eines Issues in dieser Gruppe das Feld des neuen Issues automatisch auf den Wert der Gruppe festgelegt. Wenn du deine Ansicht beispielsweise nach „Status“ gruppierst und ein Issue in der Gruppe „Todo“ erstellst, wird der „Status“ des neuen Issues automatisch auf „Todo“ festgelegt. Weitere Informationen zu Projekten findest du unter About Projects.

  1. Navigiere zu deinem Projekt.

  2. Klicke unten in einer Tabelle, Gruppe von Elementen oder einer Spalte im Boardlayout auf .

    Screenshot der Schaltfläche „Hinzufügen“ (+) unten im Projekt

  3. Klicke auf Neues Issue erstellen.

    Screenshot: Menüelement „Neues Issue erstellen“

  4. Wähle oben im Dialogfeld „Neues Issue erstellen“ das Repository aus, in dem das neue Issue erstellt werden soll.

    Screenshot: Dropdownmenü des Repositorys

  5. Gib unterhalb des Dropdownmenüs des Repositorys einen Titel für das neue Issue ein.

    Screenshot: Feld für den Issuetitel

  6. Optional kannst du die Felder unterhalb des Titelfelds verwenden, um zugewiesene Personen, Bezeichnungen und Meilensteine festzulegen und das Issue anderen Projekten hinzuzufügen.

    Screenshot: Optionen für zugewiesene Personen, Bezeichnungen, Projekte und Meilensteine

  7. Gib optional eine Beschreibung für das Issue ein.

    Screenshot: Beschreibungsfeld

  8. Wenn du weitere Issues erstellen möchtest, kannst du optional auf Weitere erstellen klicken, und das Dialogfeld wird beim Erstellen des Issues erneut geöffnet.

    Screenshot: Kontrollkästchen zum Erstellen weiterer Issues

  9. Klicke auf Erstellen.

    Screenshot: Schaltfläche zum Erstellen

Erstellen eines Issues über eine klassisches Projekt-Notiz

Wenn du ein klassisches Projekt verwendest, um deine Arbeit nachzuverfolgen und zu priorisieren, kannst du Notizen in Issues umwandeln. Weitere Informationen findest du unter Informationen zu projects (classic) und unter Hinzufügen von Hinweisen zu einem project (classic).

Erstellen eines Issues aus einem Aufgabenlistenelement

Innerhalb eines Issues kannst du Arbeit mithilfe von Aufgabenlisten in kleinere Vorgänge aufteilen und den Arbeitsfortschritt bis zur Fertigstellung verfolgen. Wenn eine Aufgabe weitere Nachverfolgung oder Diskussion erfordert, kannst du die Aufgabe in ein Issue umwandeln, indem du auf die Aufgabe zeigst und in der oberen rechten Ecke der Aufgabe auf klicken. Weitere Informationen findest du unter Informationen zu Aufgabenlisten.

Erstellen eines Issues aus einer URL-Abfrage

Du kannst Issues mithilfe von Abfrageparametern eröffnen. Abfrageparameter sind optionale Bestandteile einer URL, die du anpassen kannst, um eine bestimmte Ansicht einer Webseite freizugeben, beispielsweise Suchfilterergebnisse oder eine Issue-Vorlage auf GitHub. Um eigene Abfrageparameter zu erstellen, musst du Schlüssel- und Wertepaar abgleichen.

Tipp: Du kannst auch Issuevorlagen erstellen, die mit Standardbezeichnungen, zugewiesenen Personen und einem Issuetitel geöffnet werden. Weitere Informationen findest du unter Verwenden von Vorlagen zur Förderung nützlicher Issues und Pull Requests.

Du musst die erforderlichen Berechtigungen für jede Aktion haben, um den entsprechenden Abfrageparameter zu verwenden. Um den Abfrageparameter labels verwenden zu können, benötigst du beispielsweise die Berechtigung, einem Issue eine Bezeichnung hinzuzufügen. Weitere Informationen findest du unter Repository roles for an organization.

Wenn du mithilfe von Suchparametern eine ungültige URL erstellst oder nicht über die erforderlichen Berechtigungen verfügst, gibt die URL eine 404 Not Found-Fehlerseite zurück. Wenn du eine URL erstellst, die das Serverlimit überschreitet, gibt die URL eine 414 URI Too Long-Fehlerseite zurück.

Query parameter (Abfrageparameter)Beispiel
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report erstellt ein Issue mit der Bezeichnung „bug“ (Fehler) und dem Titel „New bug report“ (Neuer Fehlerbericht).
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. erstellt ein Issue mit dem Titel „New bug report“ (Neuer Fehlerbericht) und dem Kommentar „Describe the problem“ (Beschreibe das Problem) im Issuetext.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug erstellt ein Issue mit den Bezeichnungen „help wanted“ (Hilfe benötigt) und „bug“.
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones erstellt ein Issue mit dem Meilenstein „testing milestones“ (Testmeilensteine).
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat erstellt ein Issue und weist es @octocat zu.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 erstellt ein Issue mit dem Titel „Bug fix“ (Fehlerkorrektur) und fügt es Projektboard 1 der Organisation hinzu.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md erstellt ein Issue mit einer Vorlage im Issuetext. Der Abfrageparameter template funktioniert mit Vorlagen, die in einem ISSUE_TEMPLATE-Unterverzeichnis innerhalb des Stammverzeichnisses, indocs/ oder im Verzeichnis .github/ in einem Repository gespeichert sind. Weitere Informationen findest du unter Verwenden von Vorlagen zur Förderung nützlicher Issues und Pull Requests.

Du kannst auch URL-Abfrageparameter verwenden, um benutzerdefinierte Textfelder auszufüllen, die du in Formularvorlagen für Issues definiert hast. Abfrageparameter für Issueformularfelder können auch an die Issuevorlagenauswahl übergeben werden. Weitere Informationen findest du unter Syntax für das GitHub-Formularschema.

Erstellen eines Issues aus einer code scanning-Warnung

Hinweis: Die Nachverfolgung von code scanning-Warnungen in Issues befindet sich in der Betaversion und kann noch geändert werden.

Dieses Feature unterstützt die native Ausführung der Analyse mithilfe von GitHub Actions oder die externe Ausführung der Analyse über die vorhandene CI/CD-Infrastruktur sowie code scanning-Tools von Drittanbietern, aber keine Drittanbietertools zur Nachverfolgung.

Wenn du deine Arbeit mithilfe von Issues nachverfolgst und priorisierst, kannst du mithilfe von Issues auch code scanning-Warnungen nachverfolgen. Weitere Informationen zum Erstellen von Issues zum Nachverfolgen von code scanning-Warnungen findest du unter [Nachverfolgen von code scanning-Warnungen in Issues anhand von Aufgabenlisten](/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/tracking-code-scanning-alerts-in-issues-using-task-lists).

Weiterführende Themen