Стек-трейс

Когда твой код падает, он не умирает тихо. Он оставляет признание: стену текста, мимо которой большинство людей в панике пролистывает. Эта стена — самое полезное, что ты можешь передать своему AI.

Когда программа натыкается на что-то, с чем не может справиться, она останавливается и печатает стек-трейс — след того, где она была, шаг за шагом, в момент, когда все взорвалось. Выглядит как пугающая абракадабра. Но это признание, записанное по порядку.

Черный ящик. Когда самолет падает, расследователи не стоят вокруг и не гадают. Они достают черный ящик, где записаны все приборы вплоть до последней секунды, и читают назад до точного момента, когда все пошло не так. Стек-трейс — черный ящик твоего падения. Он поймал цепочку шагов, которые выполняла программа (я делала это, потому что до этого начала то, а то началось из-за этого), и самая верхняя строка обычно показывает момент удара.

Как его реально читать. Читай его как историю, в основном с конца к началу. Программа вызывает одну вещь, та вызывает другую, та вызывает третью — шаги складываются стопкой. Когда самый глубокий шаг ломается, trace печатает всю стопку. Верхняя строка почти всегда указывает на точное место поломки и обычно называет файл и даже номер строки. Строки ниже — путь, по которому программа туда пришла. Тебе не нужно понимать каждую строку. Тебе нужна верхняя. Именно там все реально сломалось.

Важное различие, потому что это звучит как trace, который мы уже разбирали, но это не он. Distributed tracing следит за одним запросом, пока он прыгает между разными сервисами, как трек-номер, который движется через десяток складов. Стек-трейс — обратное приближение: подробный разбор внутри одной программы в тот самый момент, когда она упала. Черный ящик одного самолета, а не карта маршрутов всей авиакомпании. Один следит за запросом поперек системы. Другой разбирает одно падение на месте. Одно и то же слово "trace", но совершенно другой инструмент.

Почему это, возможно, самая практичная заметка во всей серии для тебя. Ты будешь постоянно вставлять такие штуки в AI. И вот прием, который отличает людей, выбирающихся из затыка за минуты, от тех, кто час мечется: **вставляй весь trace, а не "оно сломалось".** Полный trace дает AI точный файл, точную строку и точное несовпадение, часто type error. "Не работает" заставляет AI гадать, а в догадках живет галлюцинация. Стек-трейс позволяет диагностировать. Ты передаешь черный ящик, а не описываешь аварию по памяти.

Стек-трейс — черный ящик, а не кирпичная стена. Читай верхнюю строку как место удара и вставляй в AI все целиком. Никогда не ограничивайся "оно сломалось".