Tipp
Wenn Sie Code Quality noch nicht kennen, lesen Sie Erhöhen der Codequalitätsbewertung Ihres Repositorys für eine schrittweise Anleitung zum Überprüfen und Verbessern der Qualitätsbewertungen Ihres Repositorys.
Wie Code Quality auf Ihrem Standardbranch funktioniert
Code Quality scannt Ihren Standard-Branch und zeigt Ergebnisse auf den Seiten „Codequalität“ im Tab Security and quality Ihres Repositorys an. Es führt zwei Arten von Analysen aus.
-
** Standardergebnisse **: Code Quality verwendet CodeQL, um einen deterministischen, regelbasierten Scan Ihres Standard-Branchs durchzuführen. Die Ergebnisse sind nach Regel und Sprache gruppiert, nach Schweregrad (Fehler, Warnung, Hinweis) gekennzeichnet und enthalten jeweils eine vorgeschlagene automatische Korrektur.
-
** KI-Ergebnisse **: Code Quality verwendet KI-basierte Analysen, um Qualitätsprobleme in den Dateien zu identifizieren, die zuletzt an Ihren Standardzweig verschoben wurden, einschließlich Problemen, die regelbasierte Analysen möglicherweise nicht erkennen können – z. B. bewährte Methoden, Benennungskonventionen oder Entwurfsüberlegungen.
Hinweis
Die Seite „KI-Ergebnisse“ für zuletzt geänderte Dateien ist derzeit in Öffentliche Vorschau und kann sich ändern.
Informationen zum Auflösen KI-Ergebnissefinden Sie unter Beheben von Codequalitätsbefunden in kürzlich zusammengeführten Dateien.
Beheben eines Standardbefunds
-
Navigieren Sie zur Security and quality Registerkarte Ihres Repositorys.
-
Klicken Sie hier, um Codequalität zu erweitern, und klicken Sie dann auf Standardergebnisse.
-
Verwenden Sie die Dashboardfilter, um sich auf die Ergebnisse zu konzentrieren, die sich am ehesten auf Ihre Qualitätsbewertungen auswirken. Um beispielsweise alle Ergebnisse auf Fehlerebene für "Zuverlässigkeit" anzuzeigen, legen Sie den Filter auf Folgendes fest:
is:open category:reliability severity:error -
Ergebnisse werden nach Regel gruppiert. Klicken Sie auf den Namen einer Regel, um zur Detailansicht aller Ergebnisse für diese Regel zu gelangen.
-
Klicken Sie auf "Mehr anzeigen" und lesen Sie die Erläuterung der Regel, die empfohlene Korrektur sowie die unterstützenden Codebeispiele und Verweise.
- Klicken Sie rechts neben einem einzelnen Ergebnis auf Korrektur generieren.
- Überprüfen Sie den Diff der vorgeschlagenen Änderung. Wenn Sie damit einverstanden sind, klicken Sie auf "Pullanforderung öffnen".
- Wählen Sie im Dialogfeld "Commit autofix to branch" die Option "Pullanforderung öffnen" aus, und klicken Sie dann auf "Commit ändern".
- Wenn der Autofix-Pull-Request zur Überprüfung bereit ist, ändern Sie seinen Status von „Entwurf“ in „Bereit zur Überprüfung“ und warten Sie, bis die CI-Prüfungen erfolgreich abgeschlossen sind, bevor Sie den Pull Request zusammenführen.
- Alternativ klicken Sie auf Verwerfen, wenn ein Befund nicht relevant oder umsetzbar ist. Sie können beispielsweise einen Befund verwerfen, wenn er sich in nicht mehr gepflegtem Legacy-Code befindet, eine bekannte Ausnahme von den Coding-Standards Ihres Teams ist oder ein Fehlalarm ist, der kein echtes Qualitätsrisiko darstellt.
Um einen Wartbarkeits- oder Zuverlässigkeitswert zu erhöhen, müssen Sie jeden Befund mit dem derzeit höchsten Schweregrad beheben, der diese Metrik aktuell beeinträchtigt. Siehe Referenz für Metriken und Bewertungswerte.
Überprüfen, ob Ihre Codequalitätsbewertungen aktualisiert wurden
Kehren Sie nach dem Zusammenführen der AutoFix-Pullanforderungen zur Ansicht "Standardergebnisse" zurück, um zu bestätigen, dass:
- Die Zahl der Ergebnisse ist zurückgegangen.
- Die Wartbarkeits- oder Zuverlässigkeitsbewertung verbessert sich, falls Sie alle Befunde der aktuell niedrigsten Schweregradstufe für diese Metrik behoben haben.