# Инструкция по деплойменту проекта на Vercel

> [HTML-версия](https://learnvibecoding.ru/publiclessons/instruktsiya-po-deploymentu-proekta-na-vercel) · [Индекс для LLM](https://learnvibecoding.ru/llms.txt) · [Политика использования материалов](https://learnvibecoding.ru/politika-materialov)
> Материалы защищены. Обучение LLM без согласия запрещено. При разрешённом использовании — обязательна прямая ссылка на страницу-источник.

**Курс:** Дополнительные материалы

# Инструкция по деплойменту проекта на Vercel

## 1. Подключение репозитория к Vercel

1. Перейдите в Vercel → Add New Project.
2. Выберите GitHub и найдите нужный репозиторий.
3. Подтвердите импорт и дождитесь первого автоматического билда.
4. Если проект успешно собрался — появится зеленая галочка и активный деплой.

---

## 2. Запуск деплоя через Git

Каждый пуш внутри Cursor  в основную ветку (или выбранную в настройках) автоматически запускает новый деплой на Vercel.

Шаги:

1. Внести изменения в код.
2. Выполнить команды:

```
git add .
git commit -m "Описание изменений"
git push

```

Перейти в Vercel → Deployments и проверить, появилась ли новая строка деплоя.

# Решения возможных проблем при деплое проекта

## 1.  Если билд упал (красная галочка в Vercel или GitHub Actions)

1. Кликните на упавший деплой.
2. Откройте логи.
3. Найдите ошибку (обычно в последних 20–30 строках).

Типовые причины:

- отсутствует environment variable;
- неправильный путь в импортируемом файле;
- ошибка сборки фреймворка (Next.js, React и т. д.);
- конфликт версий Node.js или зависимостей.
1. Отправьте ошибку в вашего помощника для кода
2. Исправьте ошибку локально 
3. `git commit` → `git push` → 
4. проверяйте новый деплой в Vercel

---

## 2. Если новая строка деплоя НЕ появилась

Это означает, что GitHub не инициировал билд. Возможные причины:

- ошибка подключения репозитория к Vercel;
- неправильные Git-учетные данные на локальной машине;
- пуш выполнен от пользователя, не привязанного к вашему Vercel.

### Что проверить:

1. Зайдите в репозиторий на GitHub → Actions.
2. Если есть красный крестик — сборка упала.
3. Откройте лог ошибки и посмотрите, какая операция завершилась неуспешно.

---

## 2.1 Проблема с авторизацией Git-пользователя

Частая ошибка: коммит делает локальный пользователь, который не совпадает с GitHub-аккаунтом, подключенным к Vercel.

### Как проверить текущий git-пользователь:

```
git config --global user.email
git config --global user.name

```

### Как правильно выставить данные:

```
git config --global user.email "ваш_email_на_GitHub"
git config --global user.name "ваше_имя_на_GitHub"

```

После обновления конфигурации:

1. Сделайте новый коммит.
2. Выполните `git push`.
3. Вернитесь в Vercel и проверьте, появилась ли новая строка деплоя.

## 6. Финальная проверка

После успешного деплоя:

1. Убедитесь, что статус — зеленая галочка.
2. Откройте Production URL или Preview URL.
3. Проверьте работоспособность ключевых маршрутов.
4. Если всё корректно — деплой завершен.

---

### Перечень возможных проблемы при деплое на Vercel

1. **Не стартует новая строка деплоя после git push.**
    
    GitHub не инициировал билд, запрос не дошёл до Vercel.
    
2. **Билд упал в GitHub Actions.**
    
    В репозитории красная галочка, внутри логов — ошибка сборки или зависимостей.
    
3. **Билд упал в Vercel.**
    
    Появилась строка деплоя, но со статусом Error — читаем логи Vercel.
    
4. **Неверный Git-пользователь.**
    
    Локальный пользователь, который делает commit/push, не совпадает с GitHub-аккаунтом, привязанным к Vercel.
    
5. **GitHub не имеет разрешений на репозиторий для Vercel.**
    
    Проект был перемещён или настройки доступа изменились; Vercel теряет права читать ветки.
    
6. **Не та ветка выбрана для деплоя.**
    
    Пуш ушёл в другую ветку, которая не подключена как Production или Preview Branch.
    
7. **Ошибки в package.json.**
    
    Неверные версии зависимостей, конфликт Node.js, неверный build script.
    
8. **Неправильный путь к файлам в импортах.**
    
    Особенно в проектах с TypeScript или переименованными папками.
    
9. **Не установлены environment variables.**
    
    На локальном окружении всё работает, а на Vercel переменная не задана, поэтому приложение падает.
    
10. **Ошибки в build-командах.**
    
    build или экспорт настроены неверно, отсутствует нужный output (например, Next.js требует `export const dynamic = "force-static"`).
    
11. **Проблемы с кэшем.**
    
    Иногда Vercel кэширует старые сборки и выдает ошибку — помогает Clean Cache + Redeploy.
    
12. **Несовместимая версия Node.js.**
    
    На Vercel по умолчанию стоит одна версия, локально — другая.
    
13. **Удалённые или перемещённые файлы после последнего пуша.**
    
    Проект собирается локально, а на Vercel найти их не может.
    
14. **Ошибка в import.meta или специфичных конструкциях.**
    
    Часто встречается в Vite/Next проектах при переходах версий.
    
15. **Проблемы с .env.local.**
    
    Файл не пушится, а переменные не добавлены в Vercel, из-за чего код ломается.
    
16. **Ошибка доступа к API-ключам.**
    
    Неправильный формат ключа или отсутствие секрета в настройках Vercel.
    
17. **Проблемы с Git LFS.**
    
    Если используются большие файлы — они не загружаются, Vercel не может их скачать.
    
18. **Конфликты в Git.**
    
    Пуш не дошёл, потому что не был решён merge conflict, и билд просто не стартовал.

[Все уроки](https://learnvibecoding.ru/publiclessons.md) · HTML: https://learnvibecoding.ru/publiclessons