KWALIFIKACJA INF3 - CZERWIEC 2022 (test 2)

PYTANIE NR 27.
Która z wymienionych zasad nie wpłynie korzystnie na zwiększenie czytelności kodu?
A.
B.
C.
D.
Wyjaśnienie poprawnej odpowiedzi:
Czytelność kodu zwykle zwiększają: znaczące nazwy, jedna instrukcja w linii oraz komentarze w miejscach trudnych. Zasada "kod bez wcięć i zbędnych enterów" nie jest traktowana jako działanie poprawiające czytelność, bo brak struktury wizualnej utrudnia szybkie skanowanie i zrozumienie bloków kodu.

Pełne wyjaśnienie:

Pytanie dotyczy dobrych praktyk poprawiających czytelność kodu, czyli takich, które ułatwiają szybkie zrozumienie programu przez inną osobę (lub przez autora po czasie). Czytelność wpływa bezpośrednio na utrzymanie aplikacji, szybkość poprawiania błędów i jakość pracy zespołowej.

Poprawna jest odpowiedź: "Kod powinien być napisany bez wcięć i zbędnych enterów." W kontekście czytelności taki zapis jest niekorzystny, ponieważ wcięcia oraz sensownie użyte puste linie pełnią rolę "struktury wizualnej". Dzięki nim łatwiej rozpoznać bloki (np. warunki, pętle, funkcje), zasięg instrukcji i zależności między fragmentami kodu. Usunięcie wcięć i łamań linii zwykle pogarsza możliwość szybkiego skanowania kodu.

Pozostałe zasady są typowymi praktykami zwiększającymi czytelność:

  • "Nazwy zmiennych powinny odzwierciedlać ich zadanie." Dobre nazwy zmniejszają konieczność zgadywania znaczenia danych i ograniczają liczbę komentarzy wyjaśniających oczywiste rzeczy. Skróty i nazwy przypadkowe zwiększają ryzyko błędnej interpretacji.
  • "W każdej linii kodu powinna występować tylko jedna instrukcja." Taki zapis ułatwia analizę, debugowanie i pracę z systemami kontroli wersji (diff). Złożone linie z wieloma instrukcjami są trudniejsze do czytania i łatwiej w nich przeoczyć błąd.
  • "Należy wprowadzać komentarze w trudniejszych częściach kodu." Komentarze mają największą wartość tam, gdzie intencja nie wynika wprost z samego kodu. Pomagają wyjaśnić "dlaczego" coś zrobiono, a nie tylko "co" robi instrukcja.

Wskazówka egzaminacyjna: gdy pytanie brzmi "która zasada nie wpłynie korzystnie", szukaj odpowiedzi, która usuwa lub osłabia elementy porządkujące kod (formatowanie, jasność intencji). W praktyce zespołowej czytelność jest zwykle wspierana przez spójny styl, narzędzia formatowania i code review.

Dodatkowe pytania

Dodatkowe pytania (FAQ):
Czytelność kodu to łatwość zrozumienia go przez człowieka: struktury, intencji i działania. Na INF.3 jest ważna, bo strony i aplikacje webowe zwykle tworzy się zespołowo, a czytelny kod ułatwia utrzymanie, poprawki i rozwój funkcji.
Najczęściej pomagają: sensowne nazwy zmiennych i funkcji, spójne wcięcia, logiczne odstępy i puste linie, jedna instrukcja na linię oraz komentarze wyjaśniające trudne fragmenty. Ważna jest też konsekwencja w całym projekcie.
Wcięcia budują strukturę wizualną: pokazują bloki, zasięg instrukcji i zależności między fragmentami. Kod może działać bez wcięć (zależy od języka), ale czytanie i przeglądanie takiego kodu jest wolniejsze i łatwiej przeoczyć błąd.
Nazwa powinna opisywać rolę danych, np. totalPrice zamiast x. Dobrą praktyką jest unikanie skrótów nieczytelnych dla innych oraz trzymanie się konwencji projektu. Dzięki temu mniej czasu traci się na domyślanie znaczenia wartości.
To dobra zasada dla czytelności, ale w praktyce bywają wyjątki (np. bardzo krótkie, oczywiste operacje). Na potrzeby egzaminu warto przyjąć, że jedna instrukcja na linię ułatwia analizę, debugowanie i porównywanie zmian w repozytorium.
Komentarze są pomocne w trudnych miejscach: wyjaśniają intencję, założenia lub nietypowe ograniczenia. Lepiej unikać komentarzy opisujących rzeczy oczywiste albo takich, które szybko się dezaktualizują. Czytelne nazwy często zastępują część komentarzy.
Częsty błąd to mylenie "krótszego" z "czytelniejszym", np. upychanie wielu instrukcji w jednej linii. Inny błąd to traktowanie formatowania jako kosmetyki. Uczniowie też przeceniają komentarze, zapominając o roli nazw i struktury kodu.
Tak. W praktyce używa się automatycznych formaterek i linterów, które wymuszają spójny styl (wcięcia, długość linii, odstępy). W projektach webowych popularne są narzędzia zintegrowane z IDE i procesem commitów, co zmniejsza liczbę sporów o styl.
Szukaj opcji, która usuwa elementy porządkujące albo utrudnia skanowanie kodu: brak wcięć, "ściana tekstu", wiele instrukcji naraz, przypadkowe nazwy. Zasady poprawiające czytelność zwykle zwiększają przejrzystość i przewidywalność zapisu.
Ćwicz czytanie i poprawianie krótkich fragmentów kodu: zmień nazwy na znaczące, dodaj wcięcia, rozbij linie z wieloma instrukcjami, dopisz komentarz tylko tam, gdzie intencja jest niejasna. Warto też znać podstawowe zasady style guide dla wybranego języka.
info

To pytanie poprawnie rozwiązuje 75% zdających egzamin. średnio łatwe

Specjaliści zwracają uwagę: "Czytelność kodu zwykle zwiększają: znaczące nazwy, jedna instrukcja w linii oraz komentarze w miejscach trudnych."

Źródła:

  • PEP 8 – Style Guide for Python Code, sekcje: "Indentation", "Whitespace in Expressions and Statements": https://peps.python.org/pep-0008/ (dostęp: 2026-02-27)
  • Google Style Guides – ogólny zbiór zasad formatowania i czytelności kodu (m.in. znaczenie wcięć i stylu): https://google.github.io/styleguide/ (dostęp: 2026-02-27)
  • Robert C. Martin, "Clean Code: A Handbook of Agile Software Craftsmanship", rozdziały o czytelności, nazwach i komentarzach, Prentice Hall, 2008

Materiały:

  • Dokumentacje style guide dla wybranego języka (np. JavaScript/TypeScript/Python)
  • Książka o dobrych praktykach utrzymania kodu (np. Clean Code)
  • Materiały o lintingu i formatowaniu (ESLint, Prettier, narzędzia IDE)

Aktualizacja pytania: 31.03.2026



Aktualizacja pytania: 31.03.2026
📡 Brak połączenia internetowego