Как просмотреть неотправленные коммиты Git: Полное руководство

Чтобы перечислить непушенные коммиты Git, используйте git log origin/master..HEAD, чтобы увидеть коммиты в вашей локальной ветке, которых нет на удаленном репозитории, или git log --oneline origin/master..HEAD для компактного отображения. Сообщение “X коммитов вперед” в git status появляется, когда ваша ветка отклонилась от ее удаленного аналога, что является нормальным поведением Git, указывающим на локальные коммиты, которые еще не были запушены.

Содержание

• Понимание статуса Git
• Базовые методы для перечисления непушенных коммитов
• Расширенные команды Git для непушенных коммитов
• Понимание веток отслеживания удаленных репозиториев
• Распространенные проблемы и устранение неполадок
• Лучшие практики управления коммитами
• Автоматизация проверки коммитов

Понимание статуса Git

Статус Git предоставляет ценную информацию о состоянии вашего репозитория, включая наличие непушенных коммитов. Когда вы видите сообщение “Ваша ветка опережает ‘origin/master’ на X коммитов, 1 ветка(и) может(ут) быть(ы) быстро перемотана вперед”, это не проблема установки Git — это нормальное поведение, указывающее на то, что ваша локальная ветка содержит коммиты, которые не были запушены в удаленный репозиторий.

Это сообщение появляется, потому что Git отслеживает отношение между вашей локальной веткой и соответствующей веткой отслеживания удаленного репозитория (обычно origin/master или origin/main). Когда вы делаете коммиты локально, но не запуш их, Git распознает это отклонение и сообщает о нем соответствующим образом.

Важно: Сообщение о статусе появляется только при наличии прямого отношения между вашей локальной веткой и веткой отслеживания удаленного репозитория. Это устанавливается при выполнении git push -u origin <имя-ветки> или git pull без опции --no-track.

Базовые методы для перечисления непушенных коммитов

Использование Git Log с указанием диапазона

Самый прямой способ перечислить непушенные коммиты — использование git log с указанием диапазона:

# Показать все непушенные коммиты подробно
git log origin/master..HEAD

# Показать непушенные коммиты в сжатом формате
git log --oneline origin/master..HEAD

# Показать непушенные коммиты с патчем
git log -p origin/master..HEAD

Синтаксис origin/master..HEAD означает “показать коммиты, достижимые из HEAD, но не из origin/master”. Это эффективно показывает все локальные коммиты, которые не были запушены в удаленный репозиторий.

Альтернативные команды Log

Git предлагает несколько альтернативных способов просмотра непушенных коммитов:

# Показать коммиты, которые существуют локально, но не удаленно
git log --not --remotes=origin

# Показать коммиты, которые будут запушены при следующем пуше
git log --branches --not --remotes=origin

# Показать непушенные коммиты с автором и датой
git log --pretty=format:"%h %an %ad" --date=short origin/master..HEAD

Использование Git Log с графическим представлением

Для лучшей визуализации истории коммитов:

# Показать непушенные коммиты с графиком
git log --graph --oneline origin/master..HEAD

# Показать непушенные коммиты с детальным графиком
git log --graph --decorate --oneline origin/master..HEAD

Расширенные команды Git для непушенных коммитов

Использование Git Cherry-Pick для идентификации непушенных коммитов

# Перечислить непушенные коммиты с их хэшами
git log origin/master..HEAD --pretty=format:"%H"

# Подсчитать количество непушенных коммитов
git rev-list --count origin/master..HEAD

# Показать непушенные коммиты в обратном хронологическом порядке
git log --reverse origin/master..HEAD

Использование Git Diff для сравнения веток

Хотя это и не совсем перечисление коммитов, git diff может показать вам, какие изменения существуют локально, но не удаленно:

# Показать разницу между удаленной и локальной веткой
git diff origin/master..HEAD

# Показать сводку непушенных изменений
git diff --stat origin/master..HEAD

Использование Git Range-Select

Синтаксис выбора диапазона Git предоставляет более гибкие опции:

# Показать коммиты от удаленного к локальному (исключая удаленные коммиты)
git log HEAD ^origin/master

# Показать коммиты, которые будут запушены
git log --branches --not --remotes=origin

Понимание веток отслеживания удаленных репозиториев

Ветки отслеживания удаленных репозиториев — это механизм Git для отслеживания состояния веток удаленных репозиториев. Когда вы выполняете git clone, Git автоматически создает ветки отслеживания удаленных репозиториев, такие как origin/master, которые отражают состояние удаленного репозитория.

Проверка статуса отслеживания удаленных репозиториев

# Показать все ветки отслеживания удаленных репозиториев
git branch -r

# Показать все ветки (локальные и удаленные)
git branch -a

# Показать текущую ветку и ее апстрим
git branch -vv

Опция -vv (very verbose) показывает вам отношение между вашими локальными ветками и их ветками отслеживания удаленных репозиториев, включая количество коммитов впереди или позади.

Настройка отслеживания апстрима

Если вы не видите сообщения “опережает”, ваша ветка может быть неправильно настроена для отслеживания удаленного репозитория:

# Установить отслеживание апстрима для существующей ветки
git branch --set-upstream-to=origin/master master

# Или при первом пуше
git push -u origin master

Распространенные проблемы и устранение неполадок

Почему статус Git не показывает количество опережающих коммитов

Если git status не показывает, сколько коммитов вы опережаете, наиболее распространенные причины:

1. Нет отслеживания апстрима: Ваша локальная ветка не имеет настроенной ветки отслеживания удаленного репозитория.
2. Разные имена веток: Ваша локальная ветка может не соответствовать удаленной ветке.
3. Состояние отсоединенного HEAD: Вы не на ветке.
4. Разные имена удаленных репозиториев: Вы можете использовать имя удаленного репозитория, отличное от “origin”.

Проверка и исправление отслеживания удаленных репозиториев

# Проверить, есть ли у вашей ветки апстрим
git status

# Установить апстрим, если он отсутствует
git push --set-upstream origin <имя-ветки>

# Или для существующих веток
git branch --set-upstream-to=origin/<имя-ветки> <имя-ветки>

Работа с несколькими удаленными репозиториями

Если вы работаете с несколькими удаленными репозиториями:

# Показать коммиты, которых нет ни на одном удаленном репозитории
git log --not --remotes

# Показать коммиты, которых нет на конкретном удаленном репозитории
git log --not --remotes=origin

# Показать коммиты, которых нет ни на одном удаленном репозитории, кроме origin
git log --not --remotes=upstream

Лучшие практики управления коммитами

Регулярные привычки пуша

• Пушьте регулярно: Сделайте привычкой регулярно пушить коммиты, чтобы избежать накопления больших наборов непушенных изменений.
• Проверяйте перед пушем: Используйте git log origin/master..HEAD, чтобы проверить, что вы собираетесь запушить.
• Используйте осмысленные сообщения коммитов: Это упрощает идентификацию конкретных коммитов при просмотре.

Управление ветками

# Создать и переключиться на новую ветку с отслеживанием
git checkout -b feature-branch origin/master

# Или создать и настроить отслеживание одной командой
git switch -c feature-branch --track origin/master

Эффективное использование статуса Git

Сформируйте привычку регулярно проверять git status и понимать, что он вам сообщает:

# Проверить статус с дополнительными деталями
git status -v

# Кратко проверить статус
git status --short

Автоматизация проверки коммитов

Создание псевдонимов для часто используемых команд

Добавьте эти псевдонимы в ваш ~/.gitconfig для более легкого доступа:

[alias]
  unpushed = log --oneline origin/master..HEAD
  unpushed-count = rev-list --count origin/master..HEAD
  unpushed-graph = log --graph --oneline origin/master..HEAD
  ahead-status = branch -vv

Затем используйте их так:

git unpushed
git unpushed-count
git ahead-status

Хук pre-commit для проверки непушенных коммитов

Вы можете создать хук pre-commit, который напоминает вам запушить существующие коммиты перед созданием новых:

#!/bin/bash
# .git/hooks/pre-commit

UNPUSHED=$(git rev-list --count origin/master..HEAD)
if [ "$UNPUSHED" -gt 0 ]; then
    echo "Предупреждение: У вас есть $UNPUSHED непушенных коммитов"
    echo "Рекомендуется выполнить: git push"
fi

Сделайте его исполняемым с помощью chmod +x .git/hooks/pre-commit.

Заключение

• Используйте git log origin/master..HEAD или git log --oneline origin/master..HEAD для перечисления непушенных коммитов в вашем локальном репозитории
• Сообщение “X коммитов вперед” в git status является нормальным поведением Git, указывающим на локальные коммиты, которые еще не были запушены
• Убедитесь, что ваши ветки правильно настроены с отслеживанием удаленного репозитория с помощью git branch -vv для проверки отношений
• Создайте псевдонимы в конфигурации Git для более легкого доступа к часто используемым командам непушенных коммитов
• Сделайте регулярный пуш привычкой, чтобы избежать накопления множества непушенных коммитов
• Если git status не показывает количество опережающих коммитов, проверьте, настроено ли для вашей ветки правильное отслеживание апстрима

Понимание того, как отслеживать и управлять непушенными коммитами, необходимо для эффективной совместной работы и поддержания чистого рабочего процесса Git. Освоив эти команды и поняв отношения между локальными и удаленными ветками, вы сможете лучше управлять процессом разработки и избегать распространенных проблем.