Code ist sauber, wenn er leicht verständlich ist – für alle im Team. Sauberer Code kann von einem anderen Entwickler als seinem ursprünglichen Autor gelesen und verbessert werden. Mit der Verständlichkeit gehen Lesbarkeit, Veränderbarkeit, Erweiterbarkeit und Wartbarkeit einher.
Allgemeine Regeln
- Befolgen Sie die Standardkonventionen.
- Halte es einfach, dumm. Einfacher ist immer besser. Reduzieren Sie die Komplexität so weit wie möglich.
- Pfadfinderregel. Verlassen Sie den Campingplatz sauberer, als Sie ihn vorgefunden haben.
- Finden Sie immer die Ursache. Suchen Sie immer nach der Grundursache eines Problems.
Designregeln
- Konfigurierbare Daten auf hohem Niveau halten.
- Polymorphismus gegenüber if/else oder switch/case bevorzugen.
- Separater Multithreading-Code.
- Überkonfigurierbarkeit verhindern.
- Verwenden Sie die Abhängigkeitsinjektion.
- Befolgen Sie das Gesetz von Demeter. Eine Klasse sollte nur ihre direkten Abhängigkeiten kennen.
Tipps zur Verständlichkeit
- Seien Sie konsequent. Wenn Sie etwas auf eine bestimmte Weise tun, machen Sie alle ähnlichen Dinge auf die gleiche Weise.
- Verwenden Sie erklärende Variablen.
- Randbedingungen kapseln. Randbedingungen sind schwer zu überblicken. Legen Sie die Verarbeitung für sie an einem Ort ab.
- Dedizierte Wertobjekte dem primitiven Typ vorziehen.
- Vermeiden Sie logische Abhängigkeiten. Schreiben Sie keine Methoden, die abhängig von etwas anderem in derselben Klasse korrekt funktionieren.
- Vermeiden Sie negative Bedingungen.
Namensregeln
- Wählen Sie aussagekräftige und eindeutige Namen.
- Machen Sie eine sinnvolle Unterscheidung.
- Verwenden Sie aussprechbare Namen.
- Verwenden Sie durchsuchbare Namen.
- Ersetzen Sie magische Zahlen durch benannte Konstanten.
- Vermeiden Sie Kodierungen. Hängen Sie keine Präfixe oder Typinformationen an.
Funktionsregeln
- Klein.
- Tu eine Sache.
- Verwenden Sie beschreibende Namen.
- Bevorzugen Sie weniger Argumente.
- Haben keine Nebenwirkungen.
- Verwenden Sie keine Flag-Argumente. Methode in mehrere unabhängige Methoden aufteilen, die vom Client ohne Flag aufgerufen werden können.
Kommentarregeln
- Versuchen Sie immer, sich im Code zu erklären.
- Seien Sie nicht überflüssig.
- Fügen Sie keine offensichtlichen Geräusche hinzu.
- Verwenden Sie keine Kommentare in schließenden Klammern.
- Kommentieren Sie den Code nicht aus. Einfach entfernen.
- Verwendung als Absichtserklärung.
- Zur Verdeutlichung des Codes verwenden.
- Verwendung als Warnung vor Konsequenzen.
Quellcodestruktur
- Konzepte vertikal trennen.
- Zugehöriger Code sollte vertikal dicht erscheinen.
- Deklarieren Sie Variablen, die ihrer Verwendung nahe kommen.
- Abhängige Funktionen sollten nahe beieinander liegen.
- Ähnliche Funktionen sollten in der Nähe sein.
- Funktionen nach unten platzieren.
- Halten Sie die Warteschlangen kurz.
- Verwenden Sie keine horizontale Ausrichtung.
- Verwenden Sie Leerzeichen, um verwandte Dinge zu verknüpfen und schwach verwandte Dinge zu trennen.
- Einrückung nicht unterbrechen.
Objekte und Datenstrukturen
- Interne Struktur ausblenden.
- Datenstrukturen bevorzugen.
- Vermeiden Sie Hybridstrukturen (halb Objekt und halb Daten).
- Sollte klein sein.
- Tu eine Sache.
- Geringe Anzahl von Instanzvariablen.
- Die Basisklasse sollte nichts über ihre Derivate wissen.
- Es ist besser, viele Funktionen zu haben, als Code an eine Funktion zu übergeben, um ein Verhalten auszuwählen.
- Nicht-statische Methoden statischen Methoden vorziehen.
Tests
- Eine Behauptung pro Test.
- Lesbar.
- Schnell.
- Unabhängig.
- Wiederholbar.
Code riecht
- Steifigkeit. Die Software ist schwer zu ändern. Eine kleine Änderung führt zu einer Kaskade nachfolgender Änderungen.
- Zerbrechlichkeit. Die Software bricht an vielen Stellen aufgrund einer einzigen Änderung ab.
- Immobilität. Aufgrund der damit verbundenen Risiken und des hohen Aufwands können Sie Teile des Codes nicht in anderen Projekten wiederverwenden.
- Unnötige Komplexität.
- Unnötige Wiederholung.
- Deckkraft. Der Code ist schwer zu verstehen.
Das ist viel, denke ich, aber es gibt noch mehr.
Lesen Sie das vollständige Buch.
Vielen Dank für das Lesen der Zusammenfassung. Ich hoffe, es hilft.
Website:
https://kaleemelahi.co
Kauf mir einen Kaffee:
https://buymeacoffee.com/kaleemelahi
Das obige ist der detaillierte Inhalt vonZusammenfassung des sauberen Codes. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!