Что означает FETCH_HEAD в Git?

git pull --help говорит:

В режиме по умолчанию git pullэто сокращение от которого git fetchследует git merge FETCH_HEAD.

Что это такое FETCH_HEADи что на самом деле сливается во время git pull?

FETCH_HEADнедолговечный реф, для отслеживания того, что только что было получено из удаленного репозитория. git pullсначала вызывает git fetch, в нормальных случаях выборку ветки с пульта; FETCH_HEADуказывает на верхушку этой ветви (она хранит SHA1 коммита, как это делают ветви). git pullзатем вызывает git merge, сливаясь FETCH_HEADс текущей веткой.

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

Это немного похоже на обход git fetchбез аргументов (или git remote update), обновление всех ваших удаленных веток, затем запуск git merge origin/<branch>, но FETCH_HEADвместо этого внутреннее использование для ссылки на какой-либо отдельный ссылочный номер, вместо того, чтобы называть вещи.

FETCH_HEAD является ссылкой на подсказку последней выборки, независимо от того, была ли эта выборка инициирована непосредственно с помощью команды выборки или как часть извлечения. Текущее значение FETCH_HEAD сохраняется в .gitпапке в файле с именем, вы уже догадались, FETCH_HEAD.

Так что если я выдаю:

git fetch https://github.com/ryanmaxwell/Fragaria

FETCH_HEAD может содержать

3cfda7cfdcf9fb78b44d991f8470df56723658d3        https://github.com/ryanmaxwell/Fragaria

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

git merge FETCH_HEAD

Как упоминалось в ответе Джонатана , FETCH_HEAD соответствует файлу .git/FETCH_HEAD. Как правило, файл будет выглядеть так:

71f026561ddb57063681109aadd0de5bac26ada9                        branch 'some-branch' of <remote URL>
669980e32769626587c5f3c45334fb81e5f44c34        not-for-merge   branch 'some-other-branch' of <remote URL>
b858c89278ab1469c71340eef8cf38cc4ef03fed        not-for-merge   branch 'yet-some-other-branch' of <remote URL>

Обратите внимание, как отмечены все ветви, кроме одной not-for-merge. Нечетным является ветвь, которая была извлечена до извлечения. В итоге: FETCH_HEAD по существу соответствует удаленной версии ветви, которая в настоящее время извлечена.

Я только что открыл и использовал FETCH_HEAD. Я хотел локальную копию программного обеспечения с сервера, и я сделал

git fetch gitserver release_1

gitserverэто имя моей машины, на которой хранятся git-репозитории. release_1тег для версии программного обеспечения К моему удивлению, release_1тогда нигде не было возможности найти мою локальную машину. Я должен был напечатать

 git tag release_1 FETCH_HEAD 

завершить копирование помеченной цепочки коммитов (release_1) из удаленного хранилища в локальное. Fetch нашел удаленный тег, скопировал коммит на мой локальный компьютер, не создал локальный тег, но установил FETCH_HEADзначение коммита, чтобы я мог найти и использовать его. Затем я использовал FETCH_HEADдля создания локального тега, который соответствует тегу на пульте. Это практическая иллюстрация того, чтоFETCH_HEAD и как можно использовать, и может быть полезно для кого-то еще, задающегося вопросом, почему git fetch не делает то, что вы наивно ожидаете.

На мой взгляд, лучше избегать этой цели, и лучший способ добиться того, что я пытался сделать, это

git fetch gitserver release_1:release_1

то есть, чтобы получить release_1 и вызвать его release_1 локально. (Это источник: dest, см. Https://git-scm.com/book/en/v2/Git-Internals-The-Refspec. ; на всякий случай, если вы хотите дать ему другое имя!)

Вы можете использовать FETCH_HEADвремя от времени, хотя: -

git fetch gitserver bugfix1234
git cherry-pick FETCH_HEAD

может быть хорошим способом использования исправления с номером 1234 с вашего сервера Git и оставлением сборки мусора Git для удаления копии с сервера после того, как исправление было выбрано в текущей ветке. (Я предполагаю, что на сервере есть хороший чистый коммит с тегами, содержащий все исправления ошибок!)

git pull - это комбинация выборки с последующим слиянием. Когда происходит git fetch, он записывает главный коммит того, что он выбрал в FETCH_HEAD (просто файл с таким именем в .git), и эти коммиты затем объединяются в ваш рабочий каталог.