Formatowanie kodu odgrywa ważną rolę w przejrzystości całego kodu.
Formatowanie kodu różni się w zależności od języka programowania. Jak zatem postępować? Jeśli chcesz wiedzieć, jakie są standardy formatowania kodu w Javie, wpisz w Google „Przewodnik po stylu Java”. Spróbuj zastosować formatowanie kodu specyficzne dla Twojego języka programowania.
CleanCode rozróżnia formatowanie kodu poziomego i pionowego.
Formatowanie kodu pionowego oznacza formatowanie z góry na dół. Twój kod powinien brzmieć jak praca semestralna w szkole. Powinieneś przeczytać go od góry do dołu, bez zbyt wielu przeskoków.
Jeśli masz wiele koncepcji pomysłów w jednym pliku (zwykle wiele klas), podziel go na wiele plików. Poszczególne obszary kodu należy oddzielić pionowymi spacjami (liniami z enterem). Jest rzeczą oczywistą, że między metodami stosuje się pionowe odstępy.
To prawda, że tego samego bloku myślowego nie należy oddzielać spacjami. Poszczególne koncepcje myślowe muszą być wymienione razem w jednym pliku. Np. jeśli metoda publiczna wywołuje metodę prywatną, ta metoda prywatna powinna zostać wymieniona po metodzie publicznej. Nie ma to jednak zastosowania, jeśli na przykład wywoływana jest dana metoda prywatna. z wielu metod publicznych. W takim przypadku podąża tylko za ostatnią metodą publiczną, która ją wywołuje (zwróć uwagę, że istnieją języki programowania, które pozwalają na wywołanie metody po jej deklaracji, co oczywiście zmienia sytuację). Jeśli chodzi o członków prywatnych i publicznych, należy wymienić właściwości/metody prywatne i właściwości/metody publiczne. Kolejność, która jest pierwsza (prywatna lub publiczna) zależy od konkretnego języka programowania.
Marián Knězek