git pull

Две операции под одним именем#

git pull — это git fetch плюс соединение. Сначала git скачивает из
удалённого репозитория новые коммиты и обновляет служебные указатели вида
origin/main. Затем вливает origin/main в ту ветку, где ты стоишь, —
слиянием или перебазированием, смотря по настройке.

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

fetch, когда надо сначала посмотреть#

git fetch

From https://github.com/example/notes
   4f1c2ab..8b2d5e9  main       -> origin/main

Локальная ветка main осталась на месте, но теперь есть с чем сравнить:

git log --oneline main..origin/main
git diff main origin/main -- README.md

Первая команда перечислит коммиты, которых у тебя нет, вторая покажет
построчную разницу по конкретному файлу. Посмотрели — и только потом
вливаешь: git merge origin/main или сразу git pull.

Синтаксис и способы соединения#

git pull [источник] [ветка]

Ключ	Как соединяет
--rebase	переносит твои коммиты поверх скачанных, история остаётся линейной
--no-rebase	обычное слияние, при расхождении появляется коммит слияния
--ff-only	вливает только перемоткой; при расхождении просто отказывает
--autostash	сам откладывает незакоммиченные правки и возвращает их после

Чтобы не указывать способ каждый раз, его задают настройкой один раз на
машину:

git config --global pull.rebase true

Пример: обычное обновление#

git pull

Updating 4f1c2ab..8b2d5e9
Fast-forward
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

Слово Fast-forward означает лучший случай: своих коммитов у тебя не было,
указатель ветки просто переехал вперёд. Если бы ты успел закоммитить
что-то своё, git соединил бы две истории и вывел
Merge made by the 'ort' strategy — как устроено такое слияние, разобрано
в статье про git merge.

Пример: pull с перебазированием#

git pull --rebase

Successfully rebased and updated refs/heads/main.

Твои коммиты пересоздаются поверх чужих — с новыми хешами, но с тем же
содержимым. История получается линейной, без «ёлочки» из коммитов слияния.
Именно этим способом чаще всего отвечают на отказ сервера при отправке —
см. git push. Важное ограничение: перебазировать стоит
только свои неотправленные коммиты, иначе у коллег останется старая версия
тех же изменений.

Когда pull останавливается#

hint: You have divergent branches and need to specify how to reconcile them.
fatal: Need to specify how to reconcile divergent branches.

Git видит расхождение и не хочет выбирать за тебя. Ответ — одна из настроек
pull.rebase true, pull.rebase false или pull.ff only.

error: Your local changes to the following files would be overwritten by merge:
	README.md
Please commit your changes or stash them before you merge.
Aborting

Незакоммиченные правки столкнулись с приходящими. Закоммить их, либо
отложи командой git stash, обновись и верни git stash pop, либо
разово запусти git pull --autostash.

Третий случай — конфликт: файл изменили и ты, и коллега, в одних и тех же
строках. Git оставит в файле разметку конфликта и будет ждать решения.

Как откатиться#

Обновление не доведено до конца — отмени ту половину, что застряла:

git merge --abort

или git rebase --abort, если тянули с --rebase. Обе команды возвращают
ветку и файлы ровно в то состояние, что было до команды.

Pull уже завершился, а результат не нравится:

git reset --hard ORIG_HEAD

ORIG_HEAD — записанное git положение ветки до последней крупной
операции. Команда стирает незакоммиченные правки, поэтому убедись, что
терять нечего. Если и это не помогло, прежнее положение ветки всегда можно
найти в git reflog. Перечень остальных повседневных команд —
в шпаргалке.

План по этапам

1. Прибрать рабочий каталогЗакоммитить или отложить правки: git pull не любит незавершённую работу.
2. Скачать и посмотретьgit fetch, затем git log --oneline main..origin/main — что именно приедет.
3. Выбрать способЛинейная история — --rebase; сохранить точку соединения — обычное слияние.
4. Разобрать конфликтыПоправить файлы, git add, затем --continue соответствующей команды.
5. Проверить результатgit status чист, git log --oneline --graph -10 показывает ожидаемую картину.

Проверь себя

Источники

• Pro Git, книга на русскомГлавы про удалённые репозитории и перебазирование
  бесплатно
• Справка git pullКлючи и связь с fetch и merge
  бесплатно
• Справка git fetchЧто именно обновляет скачивание
  бесплатно

Было полезно?

Да Нет