Помилка в коді: полагодь з AI

Не панікуй: помилка — нормальна частина процесу

Коли вайбкодиш — просиш AI писати код замість себе, — рано чи пізно щось ламається: біла сторінка замість сайту, купа червоного тексту в консолі, напис «Module not found» або деплой, який не проходить. Це не ознака катастрофи — це звичайний етап роботи з кодом, з ним стикаються навіть досвідчені розробники.

Головна пастка тут — не сама помилка, а реакція на неї: перегенерувати весь проєкт з нуля, натиснути «скасувати» кілька разів навмання або написати AI «щось не працює, допоможи» без жодних деталей. Усі три варіанти або не вирішують проблему, або створюють нову поверх старої.

Алгоритм цього уроку простий: знайти точний текст помилки → дати AI контекст → зрозуміти причину → перевірити фікс → уміти відкотитись, якщо стало гірше.

Порада Якщо перше бажання — видалити все і почати заново, зроби паузу. У більшості випадків помилку можна полагодити за кілька хвилин, не втрачаючи вже зроблену роботу.

Знайди, де ховається текст помилки

AI не бачить твій екран. Щоб він допоміг, спочатку потрібно знайти точний текст помилки — вона завжди десь є, навіть коли на сторінці просто порожньо. Залежно від ситуації, дивись у трьох місцях:

• Біла або порожня сторінка в браузері — відкрий консоль розробника: клавіша F12 (або Cmd+Option+I на Mac) → вкладка Console. Помилка буде червоним текстом.
• Працюєш локально й запускаєш проєкт командою на кшталт npm run dev — дивись у вікно термінала, де запущена ця команда. Помилка там теж червона, з назвою файлу і номером рядка.
• Сайт не публікується (деплой на Vercel, Netlify тощо) — відкрий лог останнього деплою (Deployment Logs) і шукай напис на кшталт Build Failed. Текст помилки буде одразу над ним або під ним.

Порада Термінал і консоль браузера показують різні помилки. Якщо в одному місці порожньо — обов'язково перевір інше.

Скопіюй ПОВНИЙ текст помилки — не перекажи своїми словами

Текст помилки — це не «страшна нісенітниця», яку варто ігнорувати. Це діагноз: у ньому майже завжди є назва файлу, номер рядка й тип проблеми. Якщо переказати своїми словами («щось про модуль»), AI втрачає більшість корисної інформації.

Як скопіювати правильно:

• У консолі браузера — клікни на рядок помилки правою кнопкою → Copy, або виділи текст вручну. Якщо помилка займає кілька рядків з деталями — копіюй усе.
• У терміналі — виділи текст від першого червоного рядка до кінця блоку, включно зі шляхом до файлу.
• Якщо текст не виділяється — зроби скріншот, але текст завжди кращий за картинку: AI працює з текстом точніше.

Не обрізай і не скорочуй — навіть рядки, які виглядають як технічне сміття (stack trace), можуть містити ключ до причини.

Порада Якщо помилок у консолі кілька — копіюй першу. Наступні часто просто наслідок першої і зникають самі, щойно полагодиш головну.

Дай AI помилку разом із контекстом — одним повідомленням

Порівняй два запити:

• Слабкий: «сайт не працює, допоможи»
• Сильний: повний текст помилки + опис, у якому файлі це сталось і що мало відбуватись

AI відповідає настільки точно, наскільки точний запит. Без контексту він або вгадує причину навмання, або перепитує те, що можна було дати одразу — і ти втрачаєш зайву репліку.

Ось повна помилка, яку я бачу:

[встав ПОВНИЙ текст помилки — весь червоний блок, включно зі шляхом до файлу й номером рядка]

Контекст:
- Файл, з яким зараз працюю: [назва файлу]
- Що мало статися: [короткий опис, наприклад «форма мала надіслати дані на email»]
- Остання дія перед помилкою: [що саме змінювалось у коді або яка команда запускалась]

Поясни, що означає ця помилка, і запропонуй виправлення.

Порада Якщо AI перепитує «а який у тебе файл» — це ознака, що контексту в першому повідомленні було замало. Додай його одразу наступного разу.

Спочатку проси пояснити причину, а не тільки фікс

Готовий шматок коду, який «просто встав і працює», лагодить симптом, але не залишає розуміння, чому це сталося — і та сама помилка повертається за тиждень в іншому місці. Попроси причину окремо, до фіксу.

Це одна зайва репліка, але вона економить час на наступних помилках того самого типу — патерн уже буде знайомий.

Перш ніж пропонувати виправлення, поясни простими словами, у чому саме причина цієї помилки і чому вона виникла саме тут. Виправлення дай окремим кроком після пояснення.

Порада Якщо пояснення звучить розмито («іноді таке буває») — попроси AI вказати конкретний рядок коду, який спричиняє проблему.

Постав фікс і перевір насправді, а не «начебто зникло»

Червоний текст зник — це ще не доказ, що все працює. Помилка в консолі могла зникнути, а функціонал так і не запрацював (наприклад, форма мовчки нічого не надсилає).

Після кожного фіксу:

• Онови сторінку в браузері (жорстке оновлення: Cmd+Shift+R або Ctrl+Shift+R, щоб скинути кеш).
• Пройди саме ту дію, яка раніше ламалась, від початку до кінця.
• Перевір консоль ще раз — чи не з'явилась нова помилка на місці старої.

Опиши кроками, як перевірити в браузері, що це виправлення дійсно вирішує задачу [опиши задачу своїми словами], а не просто прибирає повідомлення про помилку.

Відкотись, якщо стало гірше

Іноді фікс AI ламає щось, що раніше працювало. У такому разі не намагайся лагодити поверх поламаного — спочатку поверни попередній робочий стан.

Якщо проєкт підключений до git — це найнадійніший спосіб: кожна версія коду збережена, і повернутись можна за секунди. Якщо git не налаштований, попроси AI показати різницю (diff) і повернути тільки той файл, який зламався.

Покажи, що саме змінилось у файлі [назва файлу] за останнє виправлення — виведи різницю (diff) між попередньою і поточною версією. Після цього поверни файл до попередньої версії: це виправлення зробило гірше, а не краще.

Порада Якщо працюєш через git — став за звичку зберігати версію (робити коміт) щоразу, коли щось точно працює. Тоді відкат — це одна команда, а не відновлення коду з пам'яті.

Коли AI ходить по колу — зміни підхід, а не тільки формулювання

Ознака замкнутого кола: AI пропонує варіант, він не допомагає, у відповідь пишеш «не спрацювало» — і отримуєш ту саму або майже ту саму пропозицію. Це сигнал, що AI не має достатньо контексту або невірно визначив причину, і повторювати запит у тому самому вигляді безглуздо.

Що зробити замість чергового «спробуй ще раз»:

• Попросити перелічити кілька окремих гіпотез причини і перевіряти їх по черзі, а не одразу видавати фікс.
• Додати контекст, якого раніше не було: інші файли, що беруть участь, повний вивід команди, що саме змінювалось до появи проблеми.
• Почати новий чат і описати задачу заново стисло — старий діалог міг «зациклитись» на неправильному напрямку.

Ми вже кілька разів пробували різні виправлення, і помилка не зникає. Останній варіант теж не спрацював — ось актуальний текст помилки:

[встав актуальний текст помилки]

Замість чергового фіксу перелічи 3 окремі гіпотези, чому це може відбуватись, від найімовірнішої до найменш імовірної. Я перевірю їх по черзі й скажу, яка підтвердилась.

Порада Новий чат — це не поразка. Свіжий контекст без «зациклених» попередніх спроб часто дає точнішу відповідь, ніж десята репліка в тому самому діалозі.