¿Qué significa FETCH_HEAD en Git?

git pull --help dice:

En su modo predeterminado, git pulles la abreviatura de git fetchseguido por git merge FETCH_HEAD.

¿Qué es esto FETCH_HEADy durante qué se fusiona realmente git pull?

FETCH_HEADes una referencia de corta duración, para realizar un seguimiento de lo que se acaba de obtener del repositorio remoto. git pullprimero invoca git fetch, en casos normales, obtener una rama del control remoto; FETCH_HEADapunta a la punta de esta rama (almacena el SHA1 de la confirmación, tal como lo hacen las ramas). git pullluego invoca git merge, fusionandoFETCH_HEAD en la rama actual.

El resultado es exactamente lo que esperaría: la confirmación en la punta de la rama remota apropiada se fusiona en la confirmación en la punta de su rama actual.

Esto es un poco como git fetchprescindir de argumentos (o git remote update), actualizar todas sus ramas remotas, luego ejecutar git merge origin/<branch>, pero usar FETCH_HEADinternamente en su lugar para referirse a cualquier referencia individual que se haya obtenido, en lugar de tener que nombrar cosas.

FETCH_HEAD es una referencia a la punta de la última búsqueda, ya sea que la búsqueda se haya iniciado directamente utilizando el comando fetch o como parte de una extracción. El valor actual de FETCH_HEAD se almacena en la .gitcarpeta en un archivo llamado, lo has adivinado,FETCH_HEAD .

Entonces, si publico:

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

FETCH_HEAD puede contener

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

Si tengo el repositorio remoto configurado como una rama de seguimiento remota, entonces puedo seguir mi búsqueda con una fusión de la rama de seguimiento. Si no lo hago, puedo fusionar la punta de la última búsqueda directamente usando FETCH_HEAD.

git merge FETCH_HEAD

Como se menciona en la respuesta de Jonathan , FETCH_HEAD corresponde al archivo .git/FETCH_HEAD. Por lo general, el archivo se verá así:

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>

Observe cómo se marcan todas las ramas menos una not-for-merge. La extraña es la rama que se desprotegió antes de la recuperación. En resumen: FETCH_HEAD corresponde esencialmente a la versión remota de la rama que está actualmente desprotegida.

Acabo de descubrir y usar FETCH_HEAD. Quería una copia local de algún software de un servidor y lo hice

git fetch gitserver release_1

gitserveres el nombre de mi máquina que almacena repositorios git. release_1es una etiqueta para una versión del software. Para mi sorpresa, release_1no se encontraba en ninguna parte de mi máquina local. Tuve que escribir

 git tag release_1 FETCH_HEAD 

para completar la copia de la cadena de confirmaciones etiquetada (release_1) desde el repositorio remoto al local. Fetch encontró la etiqueta remota, copió el commit en mi máquina local, no creó una etiqueta local, pero configuró FETCH_HEADel valor del commit para poder encontrarla y usarla. Luego solía FETCH_HEADcrear una etiqueta local que coincidía con la etiqueta en el control remoto. Esa es una ilustración práctica de lo queFETCH_HEAD es y cómo se puede usar, y podría ser útil para que alguien se pregunte por qué git fetch no hace lo que uno esperaría ingenuamente.

En mi opinión, es mejor evitarlo para ese propósito y una mejor manera de lograr lo que estaba tratando de hacer es

git fetch gitserver release_1:release_1

es decir, obtener release_1 y llamarlo release_1 localmente. (Es la fuente: dest, consulte https://git-scm.com/book/en/v2/Git-Internals-The-Refspec ; ¡en caso de que desee darle un nombre diferente!)

Sin FETCH_HEADembargo, es posible que desee usar a veces:

git fetch gitserver bugfix1234
git cherry-pick FETCH_HEAD

podría ser una buena manera de usar el número de corrección de errores 1234 de su servidor Git, y dejar la recolección de basura de Git para deshacerse de la copia del servidor una vez que la solución se ha seleccionado en su rama actual. (¡Supongo que hay una buena confirmación etiquetada limpia que contiene toda la corrección de errores en el servidor!)

git pull es una combinación de una búsqueda seguida de una fusión. Cuando sucede git fetch, observa la confirmación de la cabeza de lo que obtuvo en FETCH_HEAD (solo un archivo con ese nombre en .git) Y estas confirmaciones se fusionan en su directorio de trabajo.