Czytanie błędów kompilatora

Błędy kompilatora Zig są precyzyjne i przyjazne. Zamiast się ich obawiać, naucz się je czytać — zwykle wskazują bezpośrednio rozwiązanie.

Błąd Zig zaczyna się od pliku, numeru wiersza i kolumny, a następnie zawiera komunikat. Ta lokalizacja dokładnie wskazuje, gdzie najpierw szukać.

Pod komunikatem Zig wypisuje problematyczny wiersz oraz daszek umieszczony dokładnie pod błędnym miejscem. Wzrok od razu kieruje się na problem.

Zig traktuje nieużywaną zmienną lokalną lub import jako błąd, a nie ostrzeżenie. Dzięki temu kod pozostaje przejrzysty i nie gromadzi niepotrzebnych powiązań.

Jeśli naprawdę chcesz zignorować wartość, przypisz ją do _, czyli identyfikatora odrzucenia. Informuje to Zig, że nieużycie wartości było zamierzone.

Gdy typy się nie zgadzają, Zig podaje zarówno typ oczekiwany, jak i znaleziony. Porównanie ich obok siebie ujawnia, jakiej konwersji zabrakło.

Po błędzie Zig może wyświetlić wiersze note. Te dodatkowe wskazówki wyjaśniają powiązane szczegóły, na przykład miejsce, w którym typ został po raz pierwszy zadeklarowany.

Jeden błąd często powoduje wyświetlenie kilku komunikatów. Napraw pierwszy błąd, ponownie skompiluj program, a wiele późniejszych komunikatów często zniknie samoistnie.

Te komunikaty pojawiają się w czasie kompilacji, zanim program zostanie uruchomiony. Wczesne wykrywanie błędów jest właśnie powodem, dla którego Zig jest tak restrykcyjny.

W przypadku bardziej złożonych problemów Zig pokazuje ślad odwołań opisujący, jak kompilator dotarł do wadliwego kodu — podobnie jak ścieżka wywołań prowadząca do przyczyny.

Zawsze czytaj blok błędu od góry do dołu. Nagłówek opisuje problem, a znajdujące się niżej notatki i ślad wyjaśniają jego przyczynę.

Potrafisz już odczytywać błędy Zig: sprawdzać lokalizację i daszek, naprawiać pierwszy błąd, korzystać z notatek jako kontekstu oraz w razie potrzeby odrzucać wartości za pomocą podkreślenia. ✅