{"canonical_url":"https://engineer.company/de/glossary/code-quality/","content_markdown":"# Codequalität\n\n## Was es ist\n\nCodequalität beschreibt, wie zuverlässig Quellcode das beabsichtigte Verhalten liefert und wie gut\nMenschen ihn verstehen, prüfen und ändern können. Nehmen wir eine Funktion für die\nRechnungsstellung. Eine Version liefert bei der Beispielbestellung den richtigen Betrag, weil sie\ngenau den beim Schreiben vorgesehenen Ablauf durchläuft. Eine zweite benennt die Währung, legt die\nRundungsregel an einer Stelle fest und behandelt Gutschriften ausdrücklich. Beide können einen\nTest für den Normalfall bestehen. Wer eine strittige Rechnung untersucht, findet sich in der\nzweiten Fassung schneller zurecht.\n\nZur Korrektheit gehören Grenzfälle wie ungültige Eingaben, ein Wiederholungsversuch oder ein\nteilweise abgeschlossener Vorgang. Verständlichkeit zeigt sich daran, welche Entscheidungen die\nnächste Person beim Lesen nachvollziehen kann. Änderbarkeit hängt davon ab, wie weit sich ein\nneuer Wunsch im System auswirkt und ob sich die Folgen überprüfen lassen. Eine kurze Funktion kann\ndie falsche Steuer berechnen. Eine verwickelte Funktion kann heute korrekt sein und die nächste\nWährungsumstellung schwer überprüfbar machen.\n\nEin Code-Review hilft, diese Eigenschaften an einer konkreten Änderung zu prüfen. Ein Quality Gate\nhält Vorhaben auf, wenn festgelegte Prüfungen fehlschlagen. Technische Schulden bezeichnen\nzukünftige Kosten, die aus einer Entscheidung entstehen. Codequalität meint den Zustand des Codes\nselbst. Googles Review-Standard übersetzt das in eine alltägliche Frage. Verbessert die einzelne\nÄnderung den Zustand der Codebasis insgesamt?\n\n## Warum es wichtig ist\n\nMeist macht sich die Qualität bemerkbar, wenn eine Anforderung hinzukommt. Ein Dienst berechnet\nAngebote, stellt Rechnungen und erstattet später Zahlungen. Wenn alle drei Vorgänge dieselbe\nRabattregel getrennt umsetzen, muss das Team für die nächste Aktion sämtliche Kopien finden. Eine\nAbweichung wird womöglich erst bei der ersten Erstattung sichtbar. Eine gemeinsame Regel an einer\nbekannten Stelle und klar benannte Eingaben für jeden Aufruf machen die Folgen einer Änderung\nleichter abschätzbar.\n\nWelche Belege nützen, hängt vom Risiko ab. Bei Geldbeträgen wählt man einen Fall, in dem die\nRundung einzelner Positionen ein anderes Ergebnis liefert als die Rundung der Summe. Bei einem\nwiederholbaren Vorgang prüft man, ob die zweite Anfrage eine weitere Abbuchung auslöst. Läuft eine\nRechnung bei jedem Einkauf, lassen sich Ausführungszeit und erwartete Last messen, bevor man einen\nZwischenspeicher hinzufügt. Jede Beobachtung trägt eine Aussage mit bestimmter Reichweite.\n\nGute Qualität hilft auch bei der Übergabe. Menschen wechseln das Projekt und wer eine Änderung\nliest, kennt die Vorgeschichte oft nicht. Aussagekräftige Namen, ein ausführbares Beispiel und\neine kurze Erklärung zu einer ungewöhnlichen Vorgabe helfen, eine Entscheidung selbstständig zu\nprüfen. Diese Möglichkeit zählt bei der Fehlersuche am Wochenende ebenso wie bei der Einarbeitung.\n\n## Wie es in der Praxis aussieht\n\nAngenommen, ein Betrieb rundet den Steuerbetrag erst nach der Summierung je Steuersatz. Bei einer\nRechnung mit zwei Positionen entstehen ungerundet jeweils 0,005 Währungseinheiten Steuer. Rundet\nman jede Position auf volle Cent und rundet dabei genau in der Mitte auf, ergibt sich insgesamt\n0,02. Addiert man zuerst und rundet einmal, ergibt sich 0,01. Die Zahlen sind klein genug, um sie\nim Kopf zu prüfen. Für eine echte Rechnung ergeben sich die Regeln aus den Produktanforderungen\nund den geltenden Vorschriften.\n\nDer Vertrag der Funktion kann Eingabeeinheiten und Rechenreihenfolge benennen. Die Darstellung der\nZwischenwerte muss die nötige Genauigkeit erhalten. Die Gruppierung nach Steuersätzen soll\nerkennbar bleiben, die Rundung erfolgt an der vereinbarten Stelle. Ein Test mit den genannten\nBeträgen unterscheidet die beiden Verfahren. Zusätzlich kann ein Test mit verschiedenen\nSteuersätzen verhindern, dass bei einem Umbau alle Gruppen in einem Betrag landen. Für eine\nabweichende Regel bei Gutschriften bietet sich ein eigenes Beispiel an.\n\nBei der Prüfung verfolgen wir den Betrag, den der Kunde sieht, den exportierten Wert und den\nAufruf bei einer Erstattung. Alte Rechnungen behalten die bei der Ausstellung erfassten Beträge.\nEin Test des vollständigen Ablaufs zeigt, ob die Aufrufe die richtigen Einheiten übergeben. Ein\nisolierter Test gibt Auskunft über die Berechnung mit bestimmten Eingaben.\n\nUnser [Artikel darüber, wie das letzte Ticket nur einmal verkauft\nwird](/de/notes/selling-limited-stock-without-overselling/) wendet dieselbe Arbeitsweise auf\nBestände an. Er formuliert eine Gleichung, die stets gelten muss, beschreibt parallele Tests und\nschlägt vor, die Gleichung im Betrieb zu überwachen. An ihr lässt sich bei der Änderung\nverschiedener Abläufe ablesen, was erhalten bleiben muss.\n\n## Wo es schiefgeht\n\nMessbare Signale werden leicht mit Beweisen verwechselt. Die Testabdeckung zeigt, welche\nAnweisungen oder Zweige ausgeführt wurden. Ein Test kann trotzdem eine unzutreffende Rundungsregel\nals Sollwert festschreiben. Eine Komplexitätskennzahl weist auf prüfenswerten Code hin. Ersetzt\nman einen klaren Vergleich durch mehrere schwer erklärbare Hilfsfunktionen, kann sich die\nFehlersuche dennoch verschlechtern. Vor einem neuen Grenzwert sollte das Team benennen, welchen\nFehler der Wert erkennen soll, und Fälle auf beiden Seiten prüfen.\n\nAuch Aufräumen hat unterschiedliche Priorität. Ein unklarer Name in einem selten genutzten Bericht\nhat eine andere Wirkung als eine mehrdeutige Bedingung bei jeder Zahlung. Dokumentieren Sie das\nRisiko und trennen Sie notwendige Fehlerkorrekturen von optionalen Verbesserungen. Bei einer\nFormatfrage helfen oft eine gemeinsame Regel und ein automatischer Formatierer.\n\nEine lokale Verbesserung kann das Problem verschieben. Ein gemeinsamer Rabattbaustein passt, wenn\nmehrere Aufrufer tatsächlich dieselbe Regel brauchen. Er wird unübersichtlich, wenn er zwischen\nunterschiedlichen Regeln für Verlängerungen, Werbeaktionen und Rückerstattungen raten muss.\nBenennen Sie zunächst, welche Eingaben und Bedingungen übereinstimmen. Teilen Sie den stabilen\nTeil und halten Sie die Unterschiede sichtbar. Eine andere Person sollte die Regel am Code\nerklären und das Ergebnis prüfen können.\n\n## Weiterführende Lektüre\n\n- [Googles Maßstab für die Freigabe einer\n  Codeänderung](https://google.github.io/eng-practices/review/reviewer/standard.html)\n- [Worauf Google bei einem Code-Review\n  achtet](https://google.github.io/eng-practices/review/reviewer/looking-for.html)\n- [Unit-Tests in Software Engineering at\n  Google](https://abseil.io/resources/swe-book/html/ch12.html)\n\n\u003chttps://engineer.company/de/glossary/code-quality/\u003e\n","date_modified":"2026-11-19T06:00:51Z","description":"Wie sich Codequalität an Korrektheit, Verständlichkeit und Änderbarkeit erkennen lässt und welche Belege bei der Wahl einer Verbesserung helfen.","formats":{"gemtext":"https://engineer.company/de/glossary/code-quality/index.gmi","gopher":"https://engineer.company/de/glossary/code-quality/gophermap","html":"https://engineer.company/de/glossary/code-quality/","json":"https://engineer.company/de/glossary/code-quality/index.json","markdown":"https://engineer.company/de/glossary/code-quality/index.md","pdf":"https://engineer.company/de/glossary/code-quality/index.pdf"},"kind":"page","language":"de","title":"Was ist Codequalität?","url":"https://engineer.company/de/glossary/code-quality/","version":1}