Техниум
Начать учиться
{ гайд · для тех, кто не программист }

Дебаг без паники

Как чинить ошибки, когда AI сломал код. Практический гайд для тех, кто не программист.

    К алгоритму

    Ты написал промпт. AI сгенерировал код. Ты вставил его, нажал запуск, а вместо рабочего сайта увидел белый экран, красный текст или вообще ничего.

    Это нормально. Ошибки: часть процесса. У всех. Всегда.

    Этот гайд про то, что делать в такие моменты. Без теории программирования и сложных терминов. Просто алгоритм: случилось → делаю вот это → работает.

    { шаг 1 }

    Алгоритм «Что делать, когда всё сломалось»

    Пять шагов. Запомни их один раз, и ты перестанешь бояться ошибок.

    1. 1

      Стоп. Ничего не трогай

      Когда что-то сломалось, первый порыв: быстро что-то исправить, написать ещё один промпт, поменять код наугад. Не надо.

      Каждое случайное изменение добавляет ещё один слой проблем поверх первой. Через три таких «быстрых фикса» ты уже не понимаешь, что было изначально, что ты поменял и где вообще проблема.

      Что делать:
      Убери руки от клавиатуры. Вдохни. Переходи к шагу 2.
    2. 2

      Прочитай ошибку

      Красный текст в консоли не ругательство, а подсказка. Буквально. Там написано, что пошло не так, и часто где именно.

      Тебе не нужно понимать каждое слово. Достаточно найти:

      • Название ошибки: обычно первая строка или выделенное слово (TypeError, SyntaxError, 404 и т.д.)
      • Описание: текст после названия, который говорит, что случилось
      • Номер строки: часто указан как line 42 или file.js:42:15

      Если текста много, смотри на самый верх или самый низ. Главное обычно там.

      Что делать:
      Скопируй текст ошибки целиком. Он понадобится на шаге 4.
    3. 3

      Вспомни, что ты менял последним

      В 80% случаев причина ошибки в последнем изменении, которое ты внёс. Если до этого всё работало, а после твоего промпта сломалось, проблема скорее всего в том, что AI нагенерировал.

      • Что именно я попросил AI сделать?
      • Какие файлы изменились?
      • Работало ли до этого изменения?
      Что делать:
      Если «да, до этого работало», у тебя два пути: откатить изменение (шаг 5) или попросить AI починить (шаг 4).
    4. 4

      Попроси AI починить правильно

      Не пиши «сломалось, почини». Это как прийти к врачу и сказать «болит, лечи». Чем точнее опишешь, тем быстрее починит.

      Формула промпта

      Вот что я пытался сделать: [описание задачи] Вот что я сделал: [какой промпт дал / что изменил] Вот что произошло: [белый экран / ошибка / не работает кнопка] Вот текст ошибки: [вставить ошибку целиком] Помоги найти и исправить проблему. Объясни, что было не так.

      Что делать:
      Отправь промпт AI. Прочитай ответ. Если предлагает изменение, примени. Если снова не работает, переходи к шагу 5.
    5. 5

      Откати и попробуй иначе

      Если AI не починил с первого-второго раза, не продолжай цикл «промпт → ошибка → промпт → ошибка». С каждой итерацией код становится всё запутаннее, а AI начинает ломать ещё больше.

      • Ctrl+Z / Cmd+Z (отмена), если изменения были только что
      • Git, если делал коммиты (смотри раздел «Git как машина времени»)
      • Скопировать рабочую версию из истории чата с AI, если она там осталась
      • В Cursor или другой AI-IDE: посмотри историю файла (Timeline / Local History)

      Лучшая стратегия: вернуться к рабочей версии и подойти к задаче с другой стороны.

      После отката:
      Переформулируй задачу. Разбей на более мелкие шаги. Попроси AI сделать не всё сразу, а одну маленькую часть. Проверь. Потом следующую.
    { шаг 2 }

    Как читать ошибки

    Ошибки выглядят страшно, но большинство из них говорят очень простые вещи. Вот самые частые на человеческом языке.

    Ошибки в коде (JavaScript / React / Node.js)

    SyntaxError: Unexpected token

    Где-то в коде опечатка: лишняя скобка, забытая запятая, незакрытая кавычка.

    Как если бы в предложении забыли поставить точку и начали новое с маленькой буквы: компьютер не может «прочитать» код.

    TypeError: Cannot read properties of undefined

    Код пытается взять что-то из переменной, в которой ничего нет.

    Ты открываешь холодильник за молоком, а холодильника нет. Не молока, а самого холодильника.

    TypeError: X is not a function

    Код пытается вызвать как функцию что-то, что функцией не является.

    Ты пытаешься позвонить по книге. Книга не телефон.

    ReferenceError: X is not defined

    Код использует переменную или функцию, которая нигде не создана.

    Ты просишь передать соль Васю, а Васи за столом нет. Никто не знает, кто такой Вася.

    Module not found: Can't resolve 'xxx'

    Код подключает библиотеку, которая не установлена.

    Ты пытаешься открыть приложение, которое не скачивал. Сначала установи.

    ENOENT: no such file or directory

    Код ищет файл, которого нет по указанному пути.

    Ты ищешь документ в папке «Работа», а папки «Работа» не существует.

    Ошибки в браузере

    Белый экран (ничего не отображается)

    Ошибка в JavaScript-коде: страница «упала» до того, как успела отрисоваться.

    Открой консоль браузера: F12 (Win) / Cmd+Option+I (Mac) → вкладка Console. Там будет красный текст с ошибкой.

    404 Not Found

    Страница или файл не найдены по этому адресу.

    Ты набрал адрес квартиры, а такой квартиры в доме нет. Проверь URL.

    500 Internal Server Error

    Сервер сломался при обработке запроса. Проблема не у тебя в браузере, а на бэкенде.

    Ты позвонил в службу доставки, а у них компьютер завис. Ты всё сделал правильно, проблема на их стороне.

    CORS error (Access-Control-Allow-Origin)

    Браузер заблокировал запрос к другому сайту или серверу из соображений безопасности.

    Ты пытаешься пройти в чужой офис, а охрана не пускает: тебя нет в списке.

    ERR_CONNECTION_REFUSED

    Сервер не запущен или недоступен.

    Ты звонишь в магазин, а он закрыт.

    Ошибки при установке и запуске

    npm ERR! code ERESOLVE

    Конфликт версий библиотек: одна требует одну версию, другая другую.

    Попроси AI исправить, покажи полный текст ошибки.

    Permission denied

    У тебя нет прав на выполнение этого действия.

    На Windows запусти терминал от администратора. На Mac и Linux добавь sudo перед командой.

    Port XXXX is already in use

    Другая программа уже занимает этот порт.

    Закрой другие запущенные серверы или перезагрузи компьютер.

    { шаг 3 }

    Промпты для дебага

    Готовые формулировки. Копируй и подставляй свои данные.

    Промпт 1

    Общий дебаг (когда есть текст ошибки)

    Я работаю над [кратко описать проект, например: лендингом для фитнес-клуба]. После последнего изменения ([кратко что менял, например: добавил форму обратной связи]) появилась ошибка. Вот полный текст ошибки: [вставить ошибку] Что это значит простыми словами? Как это исправить? Покажи исправленный код.

    Промпт 2

    Когда нет ошибки, но не работает

    Я работаю над [описание проекта]. Проблема: [описать что именно не работает, например: «кнопка 'Отправить' не реагирует на нажатие» или «страница загружается, но блок с ценами пустой»]. Ошибок в консоли нет. Вот код компонента/файла, где должна быть эта логика: [вставить код] Найди, почему не работает, и покажи исправленный вариант.

    Промпт 3

    Когда AI уже пытался починить и стало хуже

    У меня была ошибка: [описание первоначальной проблемы]. Ты предложил решение, но после его применения появилась новая ошибка: [вставить новую ошибку] Давай вернёмся на шаг назад. Вот оригинальный код до всех изменений: [вставить оригинальный рабочий код или описать его] И вот задача, которую я изначально пытался решить: [описать задачу] Предложи другой подход к решению.

    Промпт 4

    Когда непонятно вообще ничего

    Я новичок и не понимаю, что происходит. Помоги разобраться. Я пытался: [что хотел сделать] Я сделал: [что конкретно делал] Результат: [что вижу на экране] Объясни максимально простым языком: 1. Что пошло не так 2. Почему 3. Как исправить (пошагово)

    Промпт 5

    Превентивный (перед внесением изменений)

    Я хочу добавить [описание фичи] в свой проект. Вот текущий код: [вставить код] Прежде чем вносить изменения, скажи: 1. Какие файлы нужно будет изменить? 2. Может ли это сломать что-то из того, что уже работает? 3. Какой самый безопасный способ это сделать?

    { шаг 4 }

    Чек-лист: перед тем как просить AI починить

    Пробегись по этим пунктам за 30 секунд. Часто проблема решается без AI.

    { шаг 5 }

    Топ-20 ошибок новичка

    Если узнал свою ситуацию, сразу бери решение.

    1. 1

      Белый экран после изменений

      F12 (Win) / Cmd+Option+I (Mac) → Console, скопируй ошибку, покажи AI

    2. 2

      npm install завершается с ошибками

      Удали папку node_modules и файл package-lock.json, запусти npm install заново

    3. 3

      Сайт не обновляется после изменений

      Ctrl+Shift+R (Win) / Cmd+Shift+R (Mac). Не помогло: перезапусти сервер

    4. 4

      Module not found: модуль не найден

      npm install [имя-пакета]. Имя: то, что написано после «Can't resolve»

    5. 5

      Кнопка не работает, ошибок нет

      Проверь обработчик клика (onClick). Покажи AI код кнопки

    6. 6

      Стили не применяются

      CSS подключён? Имена классов верные? Button и button: разные вещи

    7. 7

      Port 3000 is already in use

      Закрой все терминалы, перезапусти. Или: npm run dev -- --port 3001

    8. 8

      Ошибка CORS при запросе к API

      Проблема сервера. Покажи AI ошибку, попроси добавить CORS-заголовки

    9. 9

      Cannot read properties of undefined

      Переменная пустая. Покажи AI строку с ошибкой и код вокруг

    10. 10

      Данные из формы не отправляются

      Есть ли обработчик отправки? У полей есть name или привязка к состоянию?

    11. 11

      Картинка не отображается

      Проверь путь к файлу (чувствителен к регистру). Попробуй папку public

    12. 12

      После деплоя сайт не работает (локально работал)

      Проверь логи деплоя (Vercel и Netlify их показывают). Скопируй ошибку → AI

    13. 13

      AI сгенерировал код на другом языке или фреймворке

      Укажи конкретно: «Используй React + Tailwind» или «на чистом HTML/CSS/JS»

    14. 14

      Бесконечная загрузка страницы

      F12 (Win) / Cmd+Option+I (Mac) → Network. Запросы сыпятся без остановки? Скажи AI «бесконечный цикл запросов»

    15. 15

      Код работает, но ужасно выглядит на мобильном

      Попроси AI: «Сделай этот компонент адаптивным (responsive)»

    16. 16

      Unexpected token < в консоли

      Вместо JS загрузился HTML (страница 404). Проверь пути к файлам

    17. 17

      Переменные окружения (.env) не подтягиваются

      Перезапусти сервер. В React: REACT_APP_, в Next.js: NEXT_PUBLIC_

    18. 18

      Git пишет «nothing to commit»

      Уже закоммитил или не сохранил файл. Проверь git status

    19. 19

      Failed to compile: проект не собирается

      Там указан файл и строка. Скопируй всё и покажи AI

    20. 20

      AI «уверенно» починил, но стало хуже

      Откати (Ctrl+Z / Cmd+Z или git). Переформулируй. Разбей на шаги. Попробуй новый чат

    { шаг 6 }

    Git как машина времени

    Git сохраняет «снимки» твоего проекта. Сломалось, значит, возвращаешься к моменту, когда работало. Три команды, без теории.

    Команда 1

    Сохранить текущее состояние

    Сделать «снимок» проекта. Твоя «точка сохранения» в игре.

    bash
    git add .
    git commit -m "описание что сделал"

    Например: git commit -m "добавил форму обратной связи". Когда использовать: каждый раз, когда что-то работает. Сделал фичу, проверил, сохрани.

    Команда 2

    Посмотреть историю сохранений

    bash
    git log --oneline

    Покажет список всех «снимков»:

    bash
    a1b2c3d добавил форму обратной связи
    e4f5g6h сделал блок с ценами
    i7j8k9l первая версия лендинга

    Буквы и цифры слева: идентификатор снимка. Он нужен для отката.

    Команда 3

    Вернуться к рабочей версии

    Вариант А. Откатить незакоммиченные изменения:

    bash
    git checkout .

    Как «загрузить последнее сохранение». Всё, что менял после последнего коммита, исчезнет.

    Вариант Б. Вернуться к конкретному коммиту:

    bash
    git checkout e4f5g6h .

    Где e4f5g6h: идентификатор из git log --oneline. После не забудь сохранить:

    bash
    git add .
    git commit -m "откатился к рабочей версии"
    Золотое правило: работает → коммить
    git add . → git commit -m "что сделал" после каждого успешного шага. Тогда всегда есть куда вернуться.

    В Cursor git встроен: коммиты можно делать через панель Source Control (иконка с ветками слева).

    { шаг 7 }

    Три правила, которые спасают от 90% проблем

    Если запомнишь только три вещи из этого гайда, пусть это будут эти три.

    01
    { Маленькие шаги }

    Не проси AI сделать всё за один промпт. Одна фича → проверил → следующая. Если сломалось, знаешь где.

    02
    { Работает: коммить }

    Сделал шаг, работает, значит, git commit. Это 5 секунд, которые спасают часы. Без коммитов ты как игрок без сохранений.

    03
    { Не чини бесконечно }

    AI дважды не починил? Откатись. Переделать с нуля в вайбкодинге часто быстрее, чем чинить.

    { распечатай }

    Шпаргалка на одну страницу

    Распечатай и повесь рядом с монитором.

    Когда что-то сломалось: 5 шагов

    1. 1Стоп. Ничего не трогай. Не паникуй.
    2. 2Прочитай ошибку. F12 (Win) / Cmd+Option+I (Mac) → Console или терминал. Скопируй красный текст.
    3. 3Вспомни. Что менял последним? До этого работало?
    4. 4Попроси AI. Что пытался → что сделал → что вижу → текст ошибки → «помоги исправить».
    5. 5Не починил? Откати (Ctrl+Z / Cmd+Z или git checkout .), переформулируй, разбей на шаги.

    Быстрые проверки (30 секунд)

    ПроверьКак
    Файл сохранён?Ctrl+S / Cmd+S
    Сервер запущен?Посмотри в терминал
    Консоль браузера?F12 / Cmd+Option+I → Console
    Правильный URL?Обычно localhost:3000
    Перезапуск сервера?Ctrl+C (Win и Mac), запусти заново
    Кеш браузера?Ctrl+Shift+R / Cmd+Shift+R

    Git: три команды

    Что хочуКоманда
    Сохранитьgit add . затем git commit -m "что сделал"
    Историяgit log --oneline
    Откатитьgit checkout .

    Частые ошибки: короткие ответы

    ОшибкаЧто делать
    Белый экранF12 / Cmd+Option+I → Console → скопируй ошибку
    Module not foundnpm install [имя]
    Port in useПерезапусти терминал
    Cannot read undefinedПокажи AI строку ошибки
    CORS errorПроблема сервера → покажи AI
    npm install ошибкиУдали node_modules + package-lock.json
    Не обновляетсяCtrl+Shift+R / Cmd+Shift+R или перезапуск

    Три правила

    1. 1Маленькие шаги. Одна фича → проверка
    2. 2Работает: коммить. git add . && git commit
    3. 3Не чини бесконечно. 2 раза не починил → откати
    { курс · 6 недель }

    Вайбкодинг: с нуля до первого IT-продукта

    За 6 недель ты сможешь выйти на первые деньги на вайбкодинге за счёт создания IT-решений и автоматизаций, которые ценятся рынком, снизишь долю рутины в работе и станешь быстрее, продуктивнее и конкурентнее в IT.

    • Практика с первого дня
    • 6 реальных проектов в портфолио
    • Понятный путь к первым заказам
    Посмотреть программу курса

    «Дебаг без паники»: бонусный гайд к курсу «Вайбкодинг: с нуля до первого IT-продукта» от образовательного проекта «Техниум».