Hinweis
GitHub Code Quality ist derzeit in Öffentliche Vorschau und wird am 20. Juli 2026 allgemein verfügbar sein.
Während Öffentliche Vorschau wird Code Quality nicht in Rechnung gestellt, obwohl Code Quality Scans GitHub Actions Minuten verbrauchen. Ab dem 20. Juli 2026 fallen Gebühren für die Nutzung an. Siehe GitHub Code Quality Abrechnung.
Grundlegendes dazu, warum Ihre Pullanforderung blockiert ist
Repository-Administratoren können Qualitätsgates mithilfe von GitHub Code Quality festlegen. Wenn Sie eine Pullanforderung öffnen, werden Die Prüfungen automatisch ausgeführt, um Ihre Änderungen anhand dieser Standards auszuwerten.
Es gibt zwei Arten von Blöcken:
- Codequalitätsergebnisse: Ihre Änderungen führen zu Problemen, die unter den erforderlichen Qualitätsschwellenwert fallen.
- Schwellenwert für die Codeabdeckung: Ihre Änderungen führen dazu, dass die Codeabdeckung unter den erforderlichen Mindestwert fällt oder sich die Codeabdeckung im Vergleich zum Standard-Branch um mehr als den zulässigen Betrag verringert.
Wenn Ihr Pull Request Code einführt, der unter den erforderlichen Qualitätsgrenzwert fällt, wird unten im Pull Request im Abschnitt „Prüfungen“ ein Sperrbanner für das Zusammenführen angezeigt: „Das Zusammenführen ist blockiert: Es wurden Probleme bei der Codequalität erkannt.“
Diese Prüfungen tragen dazu bei, eine gesunde, wartungsfähige Codebasis aufrechtzuerhalten und zu verhindern, dass technische Schulden akkumuliert werden.
Anzeigen von Scanergebnissen und deren Schweregrad
Die Ergebnisse des Scans werden als Kommentare zu deinem Pull-Request gemeldet, die du mit dem github-code-quality[bot] hinterlässt. Jeder Kommentar entspricht einem bestimmten Codequalitätsproblem, das in Ihren Änderungen erkannt wurde.
Kommentare werden nach Schweregrad bezeichnet (Fehler, Warnung, Hinweis). Weitere Informationen dazu, was die Schweregrade bedeuten, finden Sie unter Schweregraden.
Ermitteln, welche Ergebnisse Ihre Pull-Anforderung blockieren
Das von Repositoryadministratoren festgelegte Qualitätsgate definiert den minimalen Schweregrad, der die Zusammenführung blockieren wird.
Das Zusammenführungsblock-Banner kann das Mindestschweregradniveau angeben. Alle Ergebnisse ab diesem Schweregrad oder höher müssen behoben werden, bevor Sie Ihren Pull Request mischen können.
Hinweis
Wenn im Banner für den Zusammenführungsblock keine Schweregradstufe angegeben ist, bedeutet dies, dass Ihr Repository die strengsten Schwellenwerte für die Codequalität verwendet, bei denen alle gefundenen Probleme vor dem Zusammenführen behoben werden müssen.
Beheben oder Schließen jeder Feststellung
Um die Blockierung Ihrer Pullanforderung aufzuheben, müssen Sie jede erforderliche Feststellung beheben, indem Sie entscheiden, ob Sie das Problem in Ihrem Code beheben oder den Kommentar verwerfen möchten.
Nutzung von Copilot Autofix und Copilot-Cloud-Agent zur Behebung von Erkenntnissen
Copilot Autofix
Kommentare zu der Pullanforderung enthalten ein vorgeschlagenes Autofix , das Sie direkt auf Ihre Pullanforderung übernehmen können. Überprüfen Sie sorgfältig die vorgeschlagene Autokorrektur auf Logik, Sicherheit und Stil, und klicken Sie dann auf Vorschlag übernehmen.
Sie benötigen keine Copilot Lizenz, um diese Vorschläge anzuwenden.
Copilot-Cloud-Agent
Alternativ, wenn Sie über eine Copilot Lizenz verfügen, können Sie die Remediierungsarbeit auch Copilot-Cloud-Agent delegieren. Kommentieren Sie die Pullanforderung und erwähnen Sie @Copilot und bitten Sie Copilot, die erkannten Probleme zu beheben.
Copilot antwortet mit einem Augen-Emoji (👀) auf Ihren Kommentar, startet eine neue Agent-Sitzung und öffnet eine Pull-Anforderung mit den erforderlichen Fixes.
Sie können die Arbeit von Copilot-Cloud-Agent nachverfolgen.
- In der Pullanforderung wird die Zusammenfassung aktualisiert, während die Arbeit fortschreitet.
- Informationen zur Verwendung der Seite „Agents” oder „Sitzungsprotokolle” finden Sie unter Verwalten von Agent-Sitzungen.
Zum Aufrufen von Copilot benötigen Sie eine Copilot-Cloud-Agent-Lizenz.
Registrieren für Copilot
Verwerfen des Ergebnisses
Sie können ein Ergebnis verwerfen, wenn es im Kontext Ihrer Codebasis nicht relevant oder umsetzbar ist. Häufige Gründe zum Zurückweisen einer Feststellung sind:
- Das Ergebnis befindet sich im Legacy-Code, der nicht mehr gepflegt wird.
- Es ist eine bekannte Ausnahme für die Codierungsstandards Ihres Teams.
- Es ist ein falsch positives Ergebnis, das kein echtes Qualitätsrisiko darstellt.
Durch das Ausblenden irrelevanter Warnungen werden Ihre Qualitätsüberprüfungen auf aussagekräftige Probleme konzentriert.
Überprüfen, ob Sie die Anforderungen erfüllt haben
Um festzustellen, ob Sie die Codequalitätsanforderungen erfüllt haben, sehen Sie sich den Abschnitt "Prüfungen" unten in Ihrer Pullanforderung an. Das Zusammenführungsblock-Banner sollte nicht mehr vorhanden sein, und Sie sollten Ihre Änderungen wie gewohnt zusammenführen können.
Beheben einer Blockierung durch den Abdeckungsschwellenwert
Wenn Ihr Pull Request durch eine Regel für den Abdeckungsschwellenwert blockiert wird, sehen Sie im Abschnitt „Checks“ ein Banner zur Zusammenführungssperre mit einer Meldung, in der beschrieben wird, welcher Schwellenwert nicht erreicht wurde. Beispiel:
- „Die Abdeckung von 22,0 % liegt unter dem Minimum von 50,0 %“: Die Branch-Abdeckung Ihres Pull-Requests liegt unter dem im Regelsatz konfigurierten Mindestwert.
- „Die Abdeckung verringerte sich um 2,5 %, der maximal zulässige Rückgang ist 1,0 %“: Ihre Änderungen haben dazu geführt, dass die Abdeckung im Vergleich zum Standardzweig um mehr als den zulässigen Betrag gesunken ist.
Um die Blockierung Ihrer Pullanforderung aufzuheben, müssen Sie Tests hinzufügen oder ändern, damit mehr codebase ausgeführt wird:
- Überprüfen Sie den Zusammenfassungskommentar zur Abdeckung Ihrer Pull-Anforderung, um zu ermitteln, welche Dateien oder Bereiche keine Abdeckung haben.
- Hinzufügen oder Aktualisieren von Tests, um die Ausführungsabdeckung zu erhöhen.
- Pushen Sie Ihre Änderungen. Die Abdeckungsprüfung wird automatisch erneut ausgeführt.
Nächste Schritte
Verringern Sie die technischen Schulden, indem Sie Die Ergebnisse in kürzlich geänderten Dateien beheben. Weitere Informationen findest du unter Verbesserung der Qualität von kürzlich zusammengeführten Codes durch KI.