Przejdź do głównej treści
Polski— Wybierz język
Menu

Debugowanie wspomagane przez AI

Lekcja 9 z 20 Zaktualizowano 29 lipca 2026 Programista
Na tej stronie
  1. Szybsze znajdowanie i naprawianie błędów
  2. Debugowanie na podstawie błędu
  3. Debugowanie nieoczekiwanego zachowania
  4. Analiza logów produkcyjnych
  5. Debugowanie metodą podziału na pół
  6. Skuteczne wzorce debugowania
  7. Zapobieganie przyszłym błędom
  8. Kluczowe wnioski

Szybsze znajdowanie i naprawianie błędów

Debugowanie to wciąż sztuka: musisz zrozumieć objaw, dotrzeć do przyczyny źródłowej i naprawić błąd, nie psując przy tym czegoś innego. Codex pomaga we wszystkich trzech krokach, ale w różnym stopniu. W pierwszym kroku wnosi niewiele, ponieważ to Ty obserwujesz objaw i wiesz, jak system powinien działać. W drugim kroku sprawdza się znakomicie, ponieważ śledzenie przepływu danych przez dziesięć plików to systematyczna praca polegająca na czytaniu – dokładnie to, co maszyna robi lepiej niż zmęczony człowiek. W trzecim kroku zapewnia natychmiastową weryfikację dzięki testom.

Debugowanie na podstawie błędu

Najprostszy przypadek: przekazujesz błąd taki, jaki jest, bez przerabiania go czy streszczania.

"The test src/api/routes/orders.test.ts fails with:
  TypeError: Cannot read properties of undefined 
  (reading 'id')
  at createOrder (src/services/order.service.ts:42)

Find the cause and fix the bug."

Agent wykonuje następnie sześć operacji w łańcuchu: odczytuje plik testowy, aby zrozumieć scenariusz, otwiera order.service.ts w linii 42, śledzi przepływ danych, aby znaleźć miejsce, w którym wprowadzono wartość undefined, identyfikuje przyczynę źródłową (brakujący parametr, błąd typowania lub coś innego), proponuje i stosuje poprawkę, a następnie ponownie uruchamia test, aby ją zweryfikować. Trzecia operacja to ta, która kosztowałaby Cię dwadzieścia minut cichego czytania.

Debugowanie nieoczekiwanego zachowania

Często nie ma żadnego błędu: program po cichu robi coś źle. To najdroższe błędy i właśnie w ich przypadku sposób sformułowania prośby ma największe znaczenie.

"The POST /api/orders route creates the order in the 
database, but the total is always 0. Product prices are 
correct in the products table. Find why the total 
calculation fails."

Ta instrukcja działa, ponieważ definiuje zakres: co działa, co nie działa, oraz jedną hipotezę, którą już wykluczono, skoro ceny w bazie danych są poprawne. Codex śledzi następnie przepływ od żądania HTTP do insercji, izoluje miejsce, w którym obliczenia idą nie tak, i proponuje rozwiązanie. Bez zdania o tabeli products najprawdopodobniej zacząłby od sprawdzenia dokładnie tego, co sam już sprawdziłeś.

Analiza logów produkcyjnych

Możesz również zacząć od śladów produkcyjnych, po prostu wklejając odpowiedni fragment.

"Here's an excerpt from production logs. The application 
intermittently returns 500 on /api/checkout:

[2026-04-01 14:23:01] ERROR: Connection pool exhausted
[2026-04-01 14:23:01] WARN: Query timeout after 30s
[2026-04-01 14:23:02] ERROR: Transaction rollback

Analyze the checkout route code and identify the connection 
leak."

Codex łączy te trzy linie – wyczerpanie puli połączeń, przekroczenie limitu czasu zapytania, wycofanie transakcji – i wnioskuje, że mamy do czynienia z wyciekiem połączeń do bazy danych. Następnie przeszukuje kod w poszukiwaniu miejsc, w których połączenie jest otwierane, ale nie zamykane poprawnie. To typowy błąd, którego żaden test nie wykryje, ponieważ ujawnia się tylko pod obciążeniem i znika, gdy tylko spróbujesz go odtworzyć lokalnie.

Debugowanie metodą podziału na pół

Gdy problem jest rozproszony, a nie zlokalizowany, poproś o metodyczne dochodzenie zamiast szybkiej naprawy.

"The TypeScript build fails with 23 type errors since the 
last dependency update. Analyze each error, identify whether 
it's an API change in a dependency, and fix the code to be 
compatible with the new versions."

Wartość tego sformułowania polega na tym, że wymusza diagnozowanie błąd po błędzie. Bez instrukcji identyfikacji źródła pokusa dla agenta – tak jak dla programisty pod koniec dnia – polega na dodawaniu typu any, dopóki kompilator nie ucichnie. To zamienia dwadzieścia trzy widoczne błędy w dwadzieścia trzy przyszłe problemy.

Skuteczne wzorce debugowania

Materiał, który dostarczasz, warunkuje wszystko inne. Każdy rodzaj objawów wymaga dołączenia specyficznych dowodów, a ich pominięcie jest jak proszenie o diagnozę bez badania.

ObjawInstrukcja dla Codex
Nieudany testPodaj pełny komunikat błędu + plik testowy
Błąd typówPodaj wynik polecenia tsc --noEmit
Błąd wykonawczyPodaj ślad stosu + kroki reprodukcji
Nieprawidłowe zachowanieOpisz wynik oczekiwany kontra zaobserwowany
Problem z wydajnościąPodaj metryki (czas odpowiedzi, wolne zapytania)

Zapobieganie przyszłym błędom

Naprawiony błąd jest tylko w połowie obsłużony, jeśli nic nie zapobiegnie jego ponownemu pojawieniu się gdzie indziej. Dlatego systematycznie uzupełniaj naprawę zadaniem konsolidującym, sformułowanym na podstawie tego, czego się właśnie dowiedziałeś.

"The bug came from an unchecked null userId. Add type 
guards in all functions in src/services/ that receive a 
userId. Also add a regression test for this case."

To drugie zadanie uogólnia wniosek tam, gdzie naprawa pozostała lokalna: strażniki typów obejmują wszystkie usługi, a test regresji zapewnia, że ten konkretny przypadek pozostanie monitorowany, nawet gdy opuścisz projekt. To ruch, który odróżnia zespół naprawiający błędy od zespołu redukującego ich zaległości.

Kluczowe wnioski

  • Dostarczaj Codexowi maksymalny kontekst: komunikaty błędów, ślady stosu, logi
  • Codex śledzi przepływ danych, aby znaleźć przyczynę źródłową
  • Weryfikuje swoją poprawkę, automatycznie ponownie uruchamiając testy
  • Po naprawie poproś o zabezpieczenia i testy regresji
  • Im precyzyjniejsze są Twoje instrukcje, tym szybsze jest debugowanie