Ветки в Git: короткое руководство для новичка

За 15–20 минут вы создадите отдельную ветку Git, внесёте в неё изменение и объедините его с основной версией проекта. Это защищает рабочий код от экспериментов: пока вы делаете новую функцию, ветка main остаётся нетронутой.

Перед началом

Инструкция рассчитана на Git 2.23 и новее: в этих версиях доступны команды git switch и git restore. Проверьте версию и убедитесь, что у вас уже есть локальный репозиторий.

• Установленный Git. Проверка: команда git --version выводит номер версии.
• Папка проекта с каталогом .git. Проверка: из папки проекта команда git status показывает состояние репозитория.
• Чистая рабочая копия без незаписанных изменений. Проверка: в выводе есть фраза nothing to commit, working tree clean или её перевод в локали системы.

Ветка — это именованный указатель на коммит. Она не копирует весь проект и обычно занимает считаные байты: Git хранит последовательность коммитов, а ветка показывает, на каком из них вы сейчас находитесь.

Ветка нужна не для хранения «версии файла», а для безопасного движения по отдельной линии истории.

Пошаговый сценарий

1. Проверьте текущую ветку

   Откройте терминал в каталоге проекта и выполните:

   git status
    git branch --show-current

   Первая команда показывает незакоммиченные изменения, вторая — имя текущей ветки. В чистом репозитории вы увидите название вроде main или master. Проверка: команда git branch --show-current печатает ровно одну ветку.

2. Создайте рабочую ветку и перейдите в неё

   Назовите ветку по задаче, а не по дате или имени компьютера:

   git switch -c feature/profile-page

   Ключ -c одновременно создаёт ветку и переключает на неё. Префикс feature/ не обязателен, но помогает отличать новые функции от исправлений, например fix/login-error. Проверка: Git выведет сообщение о переходе, а git branch --show-current вернёт feature/profile-page.

3. Измените файлы и посмотрите разницу

   Добавьте небольшой фрагмент кода или измените существующий файл. Затем проверьте состояние и отличие от последнего коммита:

   git status
   git diff

   git status перечислит изменённые файлы, а git diff покажет строки, которые добавлены или удалены. Проверка: в выводе есть именно тот файл и те строки, которые вы меняли.

4. Подготовьте изменения к коммиту

   Добавьте в индекс только нужный файл:

   git add path/to/file

   Путь замените на настоящий, например src/profile.js. Команда git diff --staged показывает то, что попадёт в коммит; это последняя возможность заметить случайный пароль, временный файл или лишние правки. Проверка: нужный файл появился в разделе Changes to be committed, а staged-разница соответствует задаче.

5. Создайте коммит

   git commit -m "Add profile page"

   Сообщение должно описывать результат, а не процесс: «Add profile page» полезнее, чем «changes». Проверка: Git сообщает, что создан коммит, а повторный git status показывает чистую рабочую копию.

6. Посмотрите историю ветки

   git log --oneline --decorate -5

   Сокращённый журнал выводит последние пять коммитов и названия указателей. У последнего коммита рядом с хешем должна стоять ваша ветка feature/profile-page. Проверка: в истории есть созданный вами коммит с ожидаемым сообщением.

7. Вернитесь в основную ветку

   Сначала узнайте её имя из шага 1. В большинстве новых проектов это main:

   git switch main

   Если у проекта основная ветка называется master, используйте это имя. Проверка: команда git branch --show-current показывает основную ветку, а файл проекта временно возвращается к состоянию до ваших изменений.

8. Объедините рабочую ветку с основной

   Находясь в основной ветке, выполните:

   git merge feature/profile-page

   Git добавит коммит рабочей ветки в историю основной. Если изменения не пересекаются, слияние завершится автоматически. Проверка: git log --oneline --decorate -5 в основной ветке показывает коммит из feature/profile-page, а git status не сообщает о незавершённом слиянии.

9. Удалите завершённую ветку

   git branch -d feature/profile-page

   Безопасный ключ -d удаляет только ветку, изменения которой уже вошли в текущую историю. Это удаляет имя указателя, но не стирает сам коммит, если он доступен через основную ветку. Проверка: команда git branch больше не показывает feature/profile-page.

git add path/to/resolved-file
git commit