Przejdź do głównej zawartości

Czysty Kod – Robert C. Martin: notatki z lektury

· 2 min aby przeczytać
Przemysław Majdak
Full-Stack Developer, Automation Engineer & Web Security Specialist

„Czysty Kod. Podręcznik dobrego programisty" Roberta C. Martina (Uncle Boba) to jedna z tych książek, które programista powinien przeczytać przynajmniej raz — a potem wracać do nich za każdym razem, gdy trafi na kod, który budzi wątpliwości.

Zebrałem z niej szczegółowe notatki z każdego rozdziału: kluczowe zasady, przykłady kodu przed i po refaktoryzacji oraz praktyczne wnioski gotowe do zastosowania od zaraz.

O książce

Oryginał nosi tytuł Clean Code: A Handbook of Agile Software Craftsmanship (2009). Książka składa się z trzech części:

  • Część I (rozdziały 1–13) — zasady i wzorce pisania czystego kodu: nazewnictwo, funkcje, komentarze, formatowanie, obsługa błędów, testy jednostkowe, klasy, systemy
  • Część II (rozdziały 14–16) — analizy przypadków: Uncle Bob bierze realny kod i czyści go krok po kroku na oczach czytelnika
  • Część III (rozdział 17) — katalog heurystyk i zapachów kodu, czyli lista rzeczy, na które warto zwracać uwagę przy code review

Notatki z rozdziałów

Każdy rozdział ma osobną stronę z praktycznym streszczeniem, przykładami kodu i wnioskami:

#Rozdział
1Czysty kod
2Znaczące nazwy
3Funkcje
4Komentarze
5Formatowanie
6Obiekty i struktury danych
7Obsługa błędów
8Granice
9Testy jednostkowe
10Klasy
11Systemy
12Powstawanie projektu
13Współbieżność
14Udane oczyszczanie kodu
15Struktura biblioteki JUnit
16Przebudowa klasy SerialDate
17Zapachy kodu i heurystyki
ADodatek A: Współbieżność II
BDodatek B: org.jfree.date.SerialDate
Epilog

Albo przejdź od razu do przeglądu wszystkich notatek.

Czego się spodziewać

Notatki nie są recenzją — są skrótem do zastosowania. Każda strona zawiera:

  • O co chodzi — tezę rozdziału w kilku zdaniach
  • Kluczowe zasady — wypunktowane, bez lania wody
  • Przykłady kodu — pary „przed i po" refaktoryzacji cytowane wprost z książki
  • Praktyczne wnioski — co zmienić w swoim kodzie po przeczytaniu

Przykłady są w Javie (język oryginalnej książki), ale zasady są uniwersalne — działają tak samo w TypeScript, Pythonie, PHP czy Go.