Как проверить, находится ли ветка Git впереди удаленной ветки

Введение

В этом практическом занятии (лабораторной работе) мы научимся проверять, находится ли ваша локальная ветка Git впереди соответствующей удаленной ветки. Это важный навык для понимания состояния вашего репозитория перед отправкой изменений. Мы рассмотрим два основных метода: использование команды git status для просмотра статуса "впереди" и использование команды git log с синтаксисом @{u}..HEAD для просмотра конкретных коммитов, которые находятся впереди.

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

Skills Graph

Проверка статуса Git на наличие коммитов впереди

На этом этапе мы научимся проверять статус нашего Git-репозитория, с особым вниманием к тому, как Git сообщает, находится ли наша локальная ветка "впереди" удаленной ветки. Это распространенная ситуация, когда вы сделали коммиты локально, но еще не отправили их в удаленный репозиторий.

Сначала убедимся, что мы находимся в директории нашего проекта. Откройте терминал и перейдите в директорию my-time-machine:

cd ~/project/my-time-machine

Теперь создадим новый файл и добавим в него некоторое содержимое. Мы симулируем внесение изменений, которые в конечном итоге закоммитим.

echo "Another message for the future" >> message.txt

Эта команда добавляет текст "Another message for the future" в существующий файл message.txt.

Далее, подготовим это изменение для коммита с помощью команды git add:

git add message.txt

Теперь создадим новый коммит с сообщением, описывающим изменения:

git commit -m "Add another message"

Вы должны увидеть вывод, похожий на следующий, который указывает на то, что новый коммит был создан:

[master 1a2b3c4] Add another message
 1 file changed, 1 insertion(+)

Отлично! Теперь мы сделали новый коммит в нашей локальной ветке master. Однако этот коммит существует только локально. Если бы у нас был удаленный репозиторий (например, на GitHub или GitLab), этого коммита еще бы не было там.

Проверим статус нашего репозитория еще раз с помощью команды git status:

git status

На этот раз вывод будет несколько другим. Вы должны увидеть что-то вроде этого:

On branch master
Your branch is ahead of 'origin/master' by 1 commit.
  (use "git push" to publish your local commits)

nothing to commit, working tree clean

Обратите внимание на строку Your branch is ahead of 'origin/master' by 1 commit.. Это Git сообщает нам, что наша локальная ветка master имеет один коммит, которого нет в ветке origin/master (которая представляет ветку master в гипотетическом удаленном репозитории с именем origin).

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

Использование git log @{u}..HEAD для просмотра коммитов, находящихся впереди

На предыдущем этапе мы увидели, что команда git status сообщила, что наша локальная ветка находится "впереди" от отслеживаемой удаленной ветки. Но как узнать, какие именно коммиты находятся впереди? Git предоставляет мощный способ сравнения веток с помощью команды git log.

Синтаксис @{u}..HEAD является сокращенной записью в Git. @{u} ссылается на upstream-ветку (отслеживаемую удаленную ветку, за которой настроена отслежка вашей текущей ветки, например origin/master), а HEAD ссылается на вершину вашей текущей локальной ветки. Таким образом, @{u}..HEAD означает "покажи мне коммиты, которые есть в моей текущей ветке (HEAD), но которых нет в upstream-ветке (@{u})".

Попробуем выполнить эту команду в терминале. Убедитесь, что вы все еще находитесь в директории ~/project/my-time-machine:

cd ~/project/my-time-machine
git log @{u}..HEAD

Вы должны увидеть запись в журнале для коммита, который мы только что сделали на предыдущем этапе:

commit 1a2b3c4d5e6f7g8h9i0j1k2l3m4n5o6p7q8r9s0 (HEAD -> master, origin/master)
Author: Jane Doe <[email protected]>
Date:   Mon Aug 7 10:00:00 2023 +0000

    Add another message

(Примечание: Хэш коммита и дата будут отличаться в вашем выводе, но сообщение коммита должно быть тем же.)

Эта команда очень полезна для того, чтобы точно увидеть, какие изменения вы собираетесь отправить в удаленный репозиторий. Она помогает вам просмотреть свою работу и убедиться, что вы отправляете только нужные коммиты.

Синтаксис @{u}..HEAD является конкретным примером нотации диапазонов в Git для команды git log. Вы можете использовать аналогичный синтаксис для сравнения любых двух коммитов или веток. Например, branch1..branch2 показывает коммиты в ветке branch2, которых нет в ветке branch1.

Понимание того, как использовать git log с нотацией диапазонов, дает вам детальный контроль над просмотром истории проекта и сравнением разных состояний вашего репозитория.

Нажмите q, чтобы выйти из режима просмотра журнала и вернуться в командную строку.

Тестирование с синхронизированными ветками

На предыдущих этапах мы увидели, что происходит, когда наша локальная ветка находится впереди от отслеживаемой удаленной ветки. Теперь давайте посмотрим, что покажут команды git status и git log @{u}..HEAD, когда наша локальная ветка синхронизирована с отслеживаемой удаленной веткой.

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

Мы можем использовать команду git reset для перемещения указателя нашей локальной ветки назад к предыдущему коммиту. Будьте осторожны при использовании git reset в реальных проектах, так как эта команда может удалить изменения! В рамках этой лабораторной работы это безопасно, так как мы просто симулируем состояние.

Убедитесь, что вы находитесь в директории ~/project/my-time-machine:

cd ~/project/my-time-machine

Теперь сбросим нашу ветку к коммиту, предшествующему последнему. Мы можем использовать HEAD~1 для ссылки на коммит перед текущим HEAD.

git reset --hard HEAD~1

Вы должны увидеть вывод, похожий на следующий, который указывает, что HEAD был перемещен назад и рабочая директория была обновлена:

HEAD is now at a1b2c3d Send a message to the future

(Примечание: Хэш коммита будет совпадать с хэшем вашего первого коммита.)

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

git status

На этот раз вывод должен показать, что ваша ветка обновлена и синхронизирована с отслеживаемой удаленной веткой:

On branch master
Your branch is up to date with 'origin/master'.

nothing to commit, working tree clean

Сообщение Your branch is up to date with 'origin/master'. говорит нам, что наша локальная ветка master синхронизирована с отслеживаемой удаленной веткой.

Наконец, давайте снова используем команду git log @{u}..HEAD, чтобы проверить, есть ли какие-либо коммиты, находящиеся впереди:

git log @{u}..HEAD

Эта команда не должна вывести никаких результатов, так как на нашей локальной ветке (HEAD) нет коммитов, которых бы не было на upstream-ветке (@{u}).

Это подтверждает, что наша локальная ветка теперь синхронизирована с отслеживаемой удаленной веткой. Понимание вывода команды git status и использование git log @{u}..HEAD являются важными навыками для управления вашим Git-воркфлоу и эффективной совместной работы.

Резюме

В этой лабораторной работе мы научились проверять, находится ли локальная ветка Git впереди соответствующей удаленной ветки. Мы начали с создания локального коммита, а затем использовали команду git status для просмотра сообщения о статусе "ahead" (впереди), которое указывает, что в локальной ветке есть коммиты, которых еще нет на удаленной.

Мы также изучили использование команды git log @{u}..HEAD для вывода списка коммитов, которые находятся впереди отслеживаемой удаленной ветки, что позволяет более детально увидеть различия. Наконец, мы проверили поведение синхронизированных веток, чтобы убедиться, что команда git status сообщает, что ветки обновлены, когда нет локальных коммитов, находящихся впереди удаленной.