git branch

Описание

git branch — основная команда управления ветками в Git. Ветки позволяют вести параллельную разработку: каждая ветка представляет собой независимую линию истории коммитов. Команда без аргументов выводит список локальных веток, помечая текущую звёздочкой *.

Технически ветка в Git — это просто именованный указатель (ref) на коммит. Создание ветки мгновенно и не копирует файлы. Когда вы делаете коммит на ветке, указатель автоматически продвигается вперёд. Это делает ветки в Git невероятно дёшевыми по сравнению с другими VCS.

Используйте git branch для: просмотра всех веток проекта, создания новой ветки от текущего HEAD, переименования существующей ветки, удаления слитых или ненужных веток, а также для просмотра информации о связи локальных веток с удалёнными.

Синтаксис

<начальная-точка> — коммит, тег или другая ветка, от которой создаётся новая ветка. По умолчанию — текущий HEAD.

Флаги и опции

Паттерны использования

# Локальные с последним коммитом и upstream
git branch -vv

# Все ветки (локальные + remote-tracking)
git branch -a

# Только удалённые
git branch -r

# Создать от текущей ветки (HEAD)
git branch feature/login

# Создать от конкретной точки
git branch hotfix/bug-42 main
git branch hotfix/bug-42 v1.2.0

# Посмотреть, что можно удалить
git branch --merged main

# Удалить слитые (кроме main и develop)
git branch --merged main | \
  grep -v -E "^\*|main|develop" | \
  xargs git branch -d

# Переименовать текущую ветку
git branch -m new-name

# Переименовать другую ветку
git branch -m old-name new-name

# Обновить remote после переименования
git push origin --delete old-name
git push origin -u new-name

# Установить upstream
git branch -u origin/main main

# Проверить связи
git branch -vv

# Сбросить upstream
git branch --unset-upstream feature/login

# Все feature-ветки
git branch --list "feature/*"

# Все ветки с "fix" в имени
git branch --list "*fix*"

# Не слитые feature-ветки
git branch --no-merged HEAD --list "feature/*"

Советы и подводные камни