Git за 15 минут: «машина времени» для твоего кода

Привет, вайб-кодер! Если ты когда-либо терял часы работы из-за случайного удаления, перезаписи или просто не мог вспомнить, какая версия кода работала вчера, то этот материал для тебя. Git — это не просто инструмент, это твоя личная «машина времени» для кода, которая позволит тебе сосредоточиться на творчестве, а не на страхе потерять прогресс.

Зачем это нужно

В мире вайб-кодинга, где эксперименты и быстрые итерации — норма, Git становится незаменимым помощником. Представь, что ты работаешь над новым промптом для нейросети, который генерирует уникальные стили изображений. Ты пробуешь разные параметры, меняешь структуру запроса. Без Git ты рискуешь потерять ту самую удачную комбинацию, которая дала прорывной результат. С Git каждый твой шаг фиксируется как «сохранёнка» в игре. Ты можешь:

• Вернуться к любой предыдущей версии: Если новый эксперимент провалился, ты всегда можешь откатиться к последней рабочей версии. Это как кнопка «отменить» для всего проекта.
• Работать над несколькими идеями одновременно: Хочешь попробовать две разные концепции для одного проекта? Создай отдельные «ветки» и развивай их параллельно, не мешая друг другу.
• Сотрудничать с другими: Если ты работаешь в команде, Git позволяет легко обмениваться изменениями, избегая конфликтов и путаницы.
• Иметь полную историю изменений: Всегда знаешь, кто, когда и что изменил в коде. Это бесценно для отладки и понимания эволюции проекта.

Как пользоваться

Git работает с тремя основными состояниями твоего кода:

1. Рабочая папка: Файлы, которые ты редактируешь прямо сейчас.
2. Индекс (staging area): Место, куда ты добавляешь файлы, которые хочешь включить в следующий коммит (git add). Думай об этом как о корзине с выбранными товарами перед оплатой.
3. История (репозиторий): Место, где хранятся все зафиксированные версии твоего кода (git commit). Это твой архив «сохранёнок».

Установка Git

Прежде чем начать, убедись, что Git установлен. Если нет:

• macOS: Открой терминал и выполни brew install git (если установлен Homebrew) или установи Xcode Command Line Tools.
• Windows: Скачай установщик с git-scm.com и следуй инструкциям. Рекомендуется использовать Git Bash.
• Ubuntu/Debian: sudo apt install git

Проверить установку можно командой git --version – она должна показать версию Git.

Шаг 1. Представься Git

Это нужно сделать один раз. Git будет знать, кто автор каждого коммита. Без этого первый commit выдаст ошибку.

git config --global user.name "Твое Имя"
git config --global user.email "твой@email.ru"
git config --global init.defaultBranch main # Чтобы новая ветка по умолчанию называлась main, а не master

Как проверить: git config --global --list покажет твои user.name и user.email.

Важно: Если ты используешь GitHub, GitLab или другой сервис, используй ту же почту, что и в аккаунте, чтобы твои коммиты корректно отображались в профиле.

Шаг 2. Инициализируй репозиторий и сделай первый коммит

Преврати любую папку с проектом в Git-репозиторий.

cd путь/к/твоему/проекту
git init # Создаст скрытую папку .git/ в текущей директории
git add . # Добавляет все файлы из текущей папки в индекс (staging area)
git commit -m "Первый коммит: старт проекта" # Фиксирует изменения из индекса в историю с сообщением

Как проверить: После git init ты увидишь сообщение Initialized empty Git repository in .../.git/. После git commit — информацию о том, сколько файлов было изменено.

Шаг 3. Подключи удалённый репозиторий (облако)

Создай пустой репозиторий на GitHub (или GitLab/Gitea/Bitbucket) – без README, .gitignore и лицензии. Затем скопируй URL удалённого репозитория и выполни:

git remote add origin https://github.com/твой_логин/твой_репозиторий.git
git branch -M main # Переименовать текущую ветку в main (если она master)
git push -u origin main # Отправить локальные изменения в удалённый репозиторий

Теперь твой код в облаке. git push отправляет изменения, git pull забирает их.

Шаг 4. Ежедневная работа: Изменения, коммиты, синхронизация

Это твой основной цикл работы:

1. Вносишь изменения в файлы проекта.
2. Проверяешь статус: git status покажет, какие файлы изменены, какие добавлены в индекс, а какие нет.
3. Добавляешь изменения в индекс: git add имя_файла или git add . (для всех изменённых файлов).
4. Фиксируешь изменения: git commit -m "Твоё осмысленное сообщение о коммите".
5. Отправляешь в облако: git push.
6. Получаешь изменения от других (или с другого компьютера): git pull.

Шаг 5. Ветки и откат

• Создать новую ветку: git branch новая_фича
• Переключиться на ветку: git checkout новая_фича
• Объединить ветку с текущей: Сначала переключись на main (git checkout main), затем git merge новая_фича.
• Удалить ветку: git branch -d новая_фича (после слияния).
• Откатиться к предыдущему коммиту: git log покажет историю коммитов с их ID. Скопируй ID нужного коммита и выполни git reset --hard ID_коммита. Осторожно: это перезапишет твою рабочую папку и историю!

Приёмы, о которых не пишут

• Используй .gitignore: Создай файл .gitignore в корне проекта и добавь туда имена файлов/папок, которые Git должен игнорировать (например, node_modules/, .env, *.log). Это поможет избежать лишних файлов в репозитории.
• Пиши осмысленные сообщения коммитов: Сообщение коммита — это краткое описание того, что было сделано. Хорошее сообщение поможет тебе и твоим коллегам понять историю проекта. Например: feat: добавить функцию генерации изображений, fix: исправить ошибку в парсинге промпта.
• Используй git stash для временного сохранения: Если ты работаешь над чем-то, но нужно срочно переключиться на другую задачу, а коммитить ещё рано, используй git stash. Это временно сохранит твои изменения, позволяя переключиться на другую ветку, а потом вернуться и применить их обратно (git stash pop).

Связка с движком qvib.pro

В qvib.pro мы создаём готовые правила, роли и скиллы для вайб-кодинга, чтобы ты мог быстрее запускать свои проекты. Git идеально дополняет эту философию: ты можешь использовать наши готовые шаблоны, инициализировать для них Git-репозиторий и начать кастомизировать их под свои нужды, сохраняя каждую итерацию. Это позволяет тебе экспериментировать с промптами, моделями и конфигурациями, не боясь потерять рабочую версию, и быстро возвращаться к любому этапу развития твоего проекта.

Полная карточка в арсенале: https://qvib.pro/arsenal/guides/git-15/