Алгоритм «Что делать, когда всё сломалось»
Пять шагов. Запомни их один раз, и ты перестанешь бояться ошибок.
- 1
Стоп. Ничего не трогай
Когда что-то сломалось, первый порыв: быстро что-то исправить, написать ещё один промпт, поменять код наугад. Не надо.
Каждое случайное изменение добавляет ещё один слой проблем поверх первой. Через три таких «быстрых фикса» ты уже не понимаешь, что было изначально, что ты поменял и где вообще проблема.
Что делать:Убери руки от клавиатуры. Вдохни. Переходи к шагу 2. - 2
Прочитай ошибку
Красный текст в консоли не ругательство, а подсказка. Буквально. Там написано, что пошло не так, и часто где именно.
Тебе не нужно понимать каждое слово. Достаточно найти:
- Название ошибки: обычно первая строка или выделенное слово (TypeError, SyntaxError, 404 и т.д.)
- Описание: текст после названия, который говорит, что случилось
- Номер строки: часто указан как line 42 или file.js:42:15
Если текста много, смотри на самый верх или самый низ. Главное обычно там.
Что делать:Скопируй текст ошибки целиком. Он понадобится на шаге 4. - 3
Вспомни, что ты менял последним
В 80% случаев причина ошибки в последнем изменении, которое ты внёс. Если до этого всё работало, а после твоего промпта сломалось, проблема скорее всего в том, что AI нагенерировал.
- Что именно я попросил AI сделать?
- Какие файлы изменились?
- Работало ли до этого изменения?
Что делать:Если «да, до этого работало», у тебя два пути: откатить изменение (шаг 5) или попросить AI починить (шаг 4). - 4
Попроси AI починить правильно
Не пиши «сломалось, почини». Это как прийти к врачу и сказать «болит, лечи». Чем точнее опишешь, тем быстрее починит.
Формула промптаВот что я пытался сделать: [описание задачи] Вот что я сделал: [какой промпт дал / что изменил] Вот что произошло: [белый экран / ошибка / не работает кнопка] Вот текст ошибки: [вставить ошибку целиком] Помоги найти и исправить проблему. Объясни, что было не так.
Что делать:Отправь промпт AI. Прочитай ответ. Если предлагает изменение, примени. Если снова не работает, переходи к шагу 5. - 5
Откати и попробуй иначе
Если AI не починил с первого-второго раза, не продолжай цикл «промпт → ошибка → промпт → ошибка». С каждой итерацией код становится всё запутаннее, а AI начинает ломать ещё больше.
- Ctrl+Z / Cmd+Z (отмена), если изменения были только что
- Git, если делал коммиты (смотри раздел «Git как машина времени»)
- Скопировать рабочую версию из истории чата с AI, если она там осталась
- В Cursor или другой AI-IDE: посмотри историю файла (Timeline / Local History)
Лучшая стратегия: вернуться к рабочей версии и подойти к задаче с другой стороны.
После отката:Переформулируй задачу. Разбей на более мелкие шаги. Попроси AI сделать не всё сразу, а одну маленькую часть. Проверь. Потом следующую.
Как читать ошибки
Ошибки выглядят страшно, но большинство из них говорят очень простые вещи. Вот самые частые на человеческом языке.
Ошибки в коде (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Другая программа уже занимает этот порт.
Закрой другие запущенные серверы или перезагрузи компьютер.
Промпты для дебага
Готовые формулировки. Копируй и подставляй свои данные.
Общий дебаг (когда есть текст ошибки)
Я работаю над [кратко описать проект, например: лендингом для фитнес-клуба]. После последнего изменения ([кратко что менял, например: добавил форму обратной связи]) появилась ошибка. Вот полный текст ошибки: [вставить ошибку] Что это значит простыми словами? Как это исправить? Покажи исправленный код.
Когда нет ошибки, но не работает
Я работаю над [описание проекта]. Проблема: [описать что именно не работает, например: «кнопка 'Отправить' не реагирует на нажатие» или «страница загружается, но блок с ценами пустой»]. Ошибок в консоли нет. Вот код компонента/файла, где должна быть эта логика: [вставить код] Найди, почему не работает, и покажи исправленный вариант.
Когда AI уже пытался починить и стало хуже
У меня была ошибка: [описание первоначальной проблемы]. Ты предложил решение, но после его применения появилась новая ошибка: [вставить новую ошибку] Давай вернёмся на шаг назад. Вот оригинальный код до всех изменений: [вставить оригинальный рабочий код или описать его] И вот задача, которую я изначально пытался решить: [описать задачу] Предложи другой подход к решению.
Когда непонятно вообще ничего
Я новичок и не понимаю, что происходит. Помоги разобраться. Я пытался: [что хотел сделать] Я сделал: [что конкретно делал] Результат: [что вижу на экране] Объясни максимально простым языком: 1. Что пошло не так 2. Почему 3. Как исправить (пошагово)
Превентивный (перед внесением изменений)
Я хочу добавить [описание фичи] в свой проект. Вот текущий код: [вставить код] Прежде чем вносить изменения, скажи: 1. Какие файлы нужно будет изменить? 2. Может ли это сломать что-то из того, что уже работает? 3. Какой самый безопасный способ это сделать?
Чек-лист: перед тем как просить AI починить
Пробегись по этим пунктам за 30 секунд. Часто проблема решается без AI.
Топ-20 ошибок новичка
Если узнал свою ситуацию, сразу бери решение.
- 1
Белый экран после изменений
F12 (Win) / Cmd+Option+I (Mac) → Console, скопируй ошибку, покажи AI
- 2
npm install завершается с ошибками
Удали папку node_modules и файл package-lock.json, запусти npm install заново
- 3
Сайт не обновляется после изменений
Ctrl+Shift+R (Win) / Cmd+Shift+R (Mac). Не помогло: перезапусти сервер
- 4
Module not found: модуль не найден
npm install [имя-пакета]. Имя: то, что написано после «Can't resolve»
- 5
Кнопка не работает, ошибок нет
Проверь обработчик клика (onClick). Покажи AI код кнопки
- 6
Стили не применяются
CSS подключён? Имена классов верные? Button и button: разные вещи
- 7
Port 3000 is already in use
Закрой все терминалы, перезапусти. Или: npm run dev -- --port 3001
- 8
Ошибка CORS при запросе к API
Проблема сервера. Покажи AI ошибку, попроси добавить CORS-заголовки
- 9
Cannot read properties of undefined
Переменная пустая. Покажи AI строку с ошибкой и код вокруг
- 10
Данные из формы не отправляются
Есть ли обработчик отправки? У полей есть name или привязка к состоянию?
- 11
Картинка не отображается
Проверь путь к файлу (чувствителен к регистру). Попробуй папку public
- 12
После деплоя сайт не работает (локально работал)
Проверь логи деплоя (Vercel и Netlify их показывают). Скопируй ошибку → AI
- 13
AI сгенерировал код на другом языке или фреймворке
Укажи конкретно: «Используй React + Tailwind» или «на чистом HTML/CSS/JS»
- 14
Бесконечная загрузка страницы
F12 (Win) / Cmd+Option+I (Mac) → Network. Запросы сыпятся без остановки? Скажи AI «бесконечный цикл запросов»
- 15
Код работает, но ужасно выглядит на мобильном
Попроси AI: «Сделай этот компонент адаптивным (responsive)»
- 16
Unexpected token < в консоли
Вместо JS загрузился HTML (страница 404). Проверь пути к файлам
- 17
Переменные окружения (.env) не подтягиваются
Перезапусти сервер. В React: REACT_APP_, в Next.js: NEXT_PUBLIC_
- 18
Git пишет «nothing to commit»
Уже закоммитил или не сохранил файл. Проверь git status
- 19
Failed to compile: проект не собирается
Там указан файл и строка. Скопируй всё и покажи AI
- 20
AI «уверенно» починил, но стало хуже
Откати (Ctrl+Z / Cmd+Z или git). Переформулируй. Разбей на шаги. Попробуй новый чат
Git как машина времени
Git сохраняет «снимки» твоего проекта. Сломалось, значит, возвращаешься к моменту, когда работало. Три команды, без теории.
Сохранить текущее состояние
Сделать «снимок» проекта. Твоя «точка сохранения» в игре.
git add . git commit -m "описание что сделал"
Например: git commit -m "добавил форму обратной связи". Когда использовать: каждый раз, когда что-то работает. Сделал фичу, проверил, сохрани.
Посмотреть историю сохранений
git log --oneline
Покажет список всех «снимков»:
a1b2c3d добавил форму обратной связи e4f5g6h сделал блок с ценами i7j8k9l первая версия лендинга
Буквы и цифры слева: идентификатор снимка. Он нужен для отката.
Вернуться к рабочей версии
Вариант А. Откатить незакоммиченные изменения:
git checkout .
Как «загрузить последнее сохранение». Всё, что менял после последнего коммита, исчезнет.
Вариант Б. Вернуться к конкретному коммиту:
git checkout e4f5g6h .
Где e4f5g6h: идентификатор из git log --oneline. После не забудь сохранить:
git add . git commit -m "откатился к рабочей версии"
git add . → git commit -m "что сделал" после каждого успешного шага. Тогда всегда есть куда вернуться.В Cursor git встроен: коммиты можно делать через панель Source Control (иконка с ветками слева).
Три правила, которые спасают от 90% проблем
Если запомнишь только три вещи из этого гайда, пусть это будут эти три.
Не проси AI сделать всё за один промпт. Одна фича → проверил → следующая. Если сломалось, знаешь где.
Сделал шаг, работает, значит, git commit. Это 5 секунд, которые спасают часы. Без коммитов ты как игрок без сохранений.
AI дважды не починил? Откатись. Переделать с нуля в вайбкодинге часто быстрее, чем чинить.
Шпаргалка на одну страницу
Распечатай и повесь рядом с монитором.
Когда что-то сломалось: 5 шагов
- 1Стоп. Ничего не трогай. Не паникуй.
- 2Прочитай ошибку. F12 (Win) / Cmd+Option+I (Mac) → Console или терминал. Скопируй красный текст.
- 3Вспомни. Что менял последним? До этого работало?
- 4Попроси AI. Что пытался → что сделал → что вижу → текст ошибки → «помоги исправить».
- 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 found | npm 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Маленькие шаги. Одна фича → проверка
- 2Работает: коммить.
git add . && git commit - 3Не чини бесконечно. 2 раза не починил → откати
Вайбкодинг: с нуля до первого IT-продукта
За 6 недель ты сможешь выйти на первые деньги на вайбкодинге за счёт создания IT-решений и автоматизаций, которые ценятся рынком, снизишь долю рутины в работе и станешь быстрее, продуктивнее и конкурентнее в IT.
- Практика с первого дня
- 6 реальных проектов в портфолио
- Понятный путь к первым заказам
«Дебаг без паники»: бонусный гайд к курсу «Вайбкодинг: с нуля до первого IT-продукта» от образовательного проекта «Техниум».