Skip to content

Latest commit

 

History

History
1453 lines (1014 loc) · 53.9 KB

README_es.md

File metadata and controls

1453 lines (1014 loc) · 53.9 KB
Raw

Reglas de vuelo para git

🌍 English ∙ Español ∙ Русский ∙ 简体中文∙ 한국어 ∙ Tiếng Việt ∙ Français ∙ 日本語

¿Qué son "reglas de vuelo"?

Una guía para astronautas (ahora, programadores usando git) acerca de qué hacer cuando las cosas van mal.

Las reglas de vuelo son los conocimientos adquiridos con tanto esfuerzo en manuales que enumeran, paso a paso, qué hacer si ocurre X y por qué. Básicamente, son procedimientos operativos extremadamente detallados y específicos de cada escenario. [...]

La NASA ha estado capturando nuestros errores, desastres y soluciones desde principios de la década de 1960, cuando los equipos de tierra de la era Mercurio comenzaron a recopilar "lecciones aprendidas" en un compendio que ahora enumera miles de situaciones problemáticas, desde fallas en el motor hasta fallas reventadas en computadoras, y sus soluciones.

— Chris Hadfield, An Astronaut's Guide to Life.

Convenciones para este documento

En aras de la claridad, todos los ejemplos de este documento usan un indicador de bash personalizado para señalar la rama actual y si hay cambios escalonados o no. La rama se incluye entre paréntesis, y un * al lado del nombre de la rama indica cambios realizados.

Únete al chat en https://gitter.im/k88hudson/git-flight-rules

Table of Contents generated with DocToc

Repositorios

Quiero empezar un repositorio local

Para inicializar un directorio existente como un repositorio de Git:

(my-folder) $ git init

Quiero clonar un repositorio remoto

Para clonar (copiar) un repositorio remoto, copia la url del repositorio y ejecuta:

$ git clone [url]

Editando commits

¿Qué acabo de hacer en el commit?

Digamos que simplemente hiciste cambios a ciegas con git commit -a y no estás seguro de cuál fue el contenido real de la confirmación que acabas de realizar. Puedes mostrar el último commit en su HEAD actual con:

(main)$ git show

o

$ git log -n1 -p

Escribí algo mal en el mensaje del commit

Si escribiste algo mal y todavía no has subido tu commit, puedes hacer lo siguiente para cambiar el mensaje del commit:

$ git commit --amend --only

Esto abrirá tu editor de texto por defecto, donde puedes editar el mensaje. Por otro lado, tú puedes hacer todo esto con un solo comando:

$ git commit --amend --only -m 'xxxxxxx'

Si ya has subido tu commit, puedes corregirlo usando amend y luego forzar el push, pero esto no es recomendado.

Hice un commit con el nombre y correo mal configurado

Si es un solo commit, corrígelo

$ git commit --amend --author "Nuevo autor <[email protected]>"

Si necesitas cambiar todo el historial, mira la página 'git filter-branch' del manual

Quiero remover un archivo de un commit

Para remover un archivo de un commit, haz lo siguiente:

$ git checkout HEAD^ miArchivo
$ git add -A
$ git commit --amend

Esto es particularmente útil cuando tienes un patch abierto y has hecho commit de un archivo innecesario, necesitar forzar el push para actualizar el parche en un control remoto.

Quiero borrar o remover mi último commit

Si necesitas eliminar commits, puedes usar lo siguiente. Sin embargo, cambiará irreversiblemente su historial y arruinará la historia de cualquier otra persona que ya haya clonado el repositorio. En resumen, si no estás seguro, nunca deberías hacer esto, nunca.

$ git reset HEAD^ --hard
$ git push --force-with-lease [remote] [branch]

Si no has subido tus cambios, para resetear Git al estado en el que estaba antes de realizar tu último commit (mientras mantengas tus cambios en staging):

(my-branch*)$ git reset --soft HEAD@{1}

Esto solo funciona si no subiste tu commit. Si lo hiciste, la única cosa segura por hacer es git revert SHAofBadCommit. Eso creará un nuevo commit que deshace todos los cambios del anterior commit. O, si la rama que subiste es segura ante reorganizaciones (ej. otros desarrolladores no esperan recibir cambios desde ahí), puedes usar git push --force-with-lease. Para más, mira la sección de arriba.

Eliminar/remover commit arbitrario

La misma advertencia de arriba. Nunca hagas esto si es posible.

$ git rebase --onto SHA1_OF_BAD_COMMIT^ SHA1_OF_BAD_COMMIT
$ git push --force-with-lease [remote] [branch]

O haz un rebase-interactivo y remueve la(s) línea(s) correspondientes al commit que quieres remover.

Intenté subir mi commit enmendado al repositorio remoto, pero obtuve un mensaje de error

To https://github.com/yourusername/repo.git
! [rejected]        mybranch -> mybranch (non-fast-forward)
error: failed to push some refs to 'https://github.com/tanay1337/webmaker.org.git'
hint: Updates were rejected because the tip of your current branch is behind
hint: its remote counterpart. Integrate the remote changes (e.g.
hint: 'git pull ...') before pushing again.
hint: See the 'Note about fast-forwards' in 'git push --help' for details.

Ten en cuenta que, al igual que con el rebase (ver más abajo), usar amend reemplaza el anterior commit con uno nuevo, por lo que debes forzar el push (--force-with-lease) de tus cambios si ya has hecho una confirmación previamente enmendada al repositorio remoto. ¡Ten cuidado cuando hagas esto – siempre asegúrate de especificar una rama!

(my-branch)$ git push origin mybranch --force-with-lease

En general, evita forzar el push. Es mejor crear y subir un nuevo commit que forzar el commit enmendado porque causará conflictos en el historial fuente para cualquier otro desarrolador que ha interactuado con la rama en cuestión o una de sus ramas hijas. --force-with-lease aún fallará, si alguien más estuviera trabajando en la misma rama que tú, y tu push forzado sobrescribiría sus cambios.

Si estás absolutamente seguro que nadie está trabajando en la misma rama o que tú quieres actualizar la rama incondicionalmente, puedes usar --force (-f), pero esto debería ser evitado en general.

Accidentalmente hice un hard reset y quiero mis cambios de vuelta

Si accidentalmente hiciste git reset --hard, puedes volver a obtener tus commits de vuelta ya que git mantiene un registro de todo durante unos días.

(main)$ git reflog

Verás una lista de tus antiguos commits, y un commit para el reset. Escoge el SHA del commit al que quieres retornar y has el reset de nuevo:

(main)$ git reset --hard SHA1234

Y deberías estar ubicado en ese commit.

Accidentalment hice un commit y empujé una fusión

Si accidentalmente fusionaste una rama a la principal de desarrollo antes de que esté lista para fusionar, todavía puedes deshacer esa fusión. Pero hay un problema: Un commit de fusión tiene más de un padre (usualmente 2).

El comando a usar

(feature-branch)$ git revert -m 1 <commit>

donde la opción -m 1 option menciona seleccionar el padre número 1 (la rama en la cual se hizo la fusión) como el padre a revertirlo.

Nota: el número padre no es un identificador de commit. Más bien, un commit de fusión tiene una línea Merge: 8e2ce2d 86ac2e7. El número padre empieza con el número 1 como índice, el primer identificador es número 1, el segundo es el número 2, y así

Accidentalmente hice un commit y empujé archivos que contienen data sensible

Si accidentalment empujaste archivos que contienen data sensible (contraseñas, llaves, etc.), puedes modificar el commit previo. Ten en mente que una vez que hayas hecho un commit, debes considerar cualquier información que éste contiene para ser empujado. Estos pasos pueden remover la data sensible de tu repo público o tu copia local, pero no puedes remover la data sensible de copias jaladas de otras personas. Si quieres hacer un commit de una contraseña, cámbialo de inmediato. Si hiciste commit de una llave, regenérala de inmediato. Modificar el commit enviado no es suficiente, ya que cualquiera podría haber retirado el commit original que contiene sus datos confidenciales en ese tiempo.

Si editas un archivo y remueves la data sensible, entonces ejecuta

(feature-branch)$ git add edited_file
(feature-branch)$ git commit --amend --no-edit
(feature-branch)$ git push --force-with-lease origin [branch]

Si quieres remover un archivo entero (pero mantenerlo localmente), entonces ejecuta

(feature-branch)$ git rm --cached sensitive_file
echo sensitive_file >> .gitignore
(feature-branch)$ git add .gitignore
(feature-branch)$ git commit --amend --no-edit
(feature-branch)$ git push --force-with-lease origin [branch]

Alternativamente guarda tu data sensible en variables de entorno locales.

Si quieres remover completamente un archivo completo (y no mantenerlo localmente), entonces ejecuta

(feature-branch)$ git rm sensitive_file
(feature-branch)$ git commit --amend --no-edit
(feature-branch)$ git push --force-with-lease origin [branch]

Si haz hecho otros commits durante ese tiempo (ej. la data sensible está en un commit antes de ese commit), necesitarás hacer un rebase.

Staging

Necesito agregar otros cambios al commit anterior

(mi-rama*)$ git commit --amend

Quiero agregar parte de un nuevo archivo, pero no todo el archivo

Normalmente, si deseas representar parte de un archivo, ejecuta esto:

$ git add --patch archivo.x

-p funcionará para abreviar. Esto abrirá el modo interactivo. Puedes usar la opción s para dividir la confirmación; sin embargo, si el archivo es nuevo, no tendrás esta opción. Para agregar un nuevo archivo, usa esto:

$ git add -N archivo.x

Luego, necesitarás usar la opción e para elegir manualmente qué líneas agregar. Ejecutando git diff --cached o git diff -staged se mostrará qué líneas ha comparado con las que todavía se guardan localmente.

Quiero agregar cambios en un archivo a dos commits diferentes

git add agregará el archivo completo a un commit. git add -p te permitirá seleccionar interactivamente los cambios que deseas agregar.

Quiero crear mis ediciones sin escalonar y eliminar mis ediciones escalonadas

Esto es complicado. Lo mejor que creo es que debes esconder tus ediciones sin escena. Luego, restablecer. Después de eso, muestra tus cambios ocultos y agrégalos.

$ git stash -k
$ git reset --hard
$ git stash pop
$ git add -A

Ediciones sin escena

Deseo mover mis ediciones sin escena a una nueva rama

$ git checkout -b mi-rama

Deseo mover mis ediciones sin escena a una rama diferente existente

$ git stash
$ git checkout my-rama
$ git stash pop

Quiero descartar mis cambios locales no confirmados (en escena y sin escena)

Si deseas descartar todos los cambios organizados y no supervisados ​​locales, puede hacer esto:

(mi-rama) $ git reset --hard
# o
(main) $ git checkout -f

Esto borrará todos los archivos que hayas organizado con git add:

$ git reset

Esto revertirá todos los cambios locales no confirmados (se debe ejecutar en la raíz del repositorio):

$ git checkout .

También puedes revertir cambios no confirmados a un archivo o directorio en particular:

$ git checkout [some_dir | file.txt]

Otra forma de revertir todos los cambios no confirmados (más largo de escribir, pero funciona desde cualquier subdirectorio):

$ git reset --hard HEAD

Esto eliminará todos los archivos locales sin seguimiento, por lo que solo se conservarán los archivos rastreados por Git:

$ git clean -fd

-x también eliminará todos los archivos ignorados.

Quiero descartar cambios específicos no planificados

Cuando desees deshacerse de algunos, pero no de todos los cambios en su copia de trabajo.

Verifica los cambios no deseados, mantén buenos cambios.

$ git checkout -p
# Responde y a todos los cambios que desea eliminar

Otra estrategia implica el uso de stash. Guarda todos los buenos cambios, restablece la copia de trabajo y vuelve a aplicar los buenos cambios.

$ git stash -p
# Selecciona todos los cambios que desea guardar
$ git reset --hard
$ git stash pop

Alternativamente, oculta sus cambios no deseados, y luego deja el escondite.

$ git stash -p
# Selecciona todos los cambios que no quiere guardar
$ git stash drop

Quiero descartar archivos específicos no escaneados

Cuando desees deshacerse de un archivo específico en su copia de trabajo.

$ git checkout myFile

Alternativamente, para descartar varios archivos en su copia de trabajo, enumera todos.

$ git checkout myFirstFile mySecondFile

Deseo descartar solo mis cambios locales sin escenario

Cuando desees deshacerse de todos sus cambios no confirmados locales sin confirmar

$ git checkout .

Quiero descartar todos mis archivos sin seguimiento

Cuando desees deshacerse de todos sus archivos sin seguimiento

$ git clean -f

Ramas

Quiero enumerar todas las ramas

Enumerar ramas locales

$ git branch

Enumerar ramas remotas

$ git branch -r

Listar todas las ramas (tanto locales como remotas)

$ git branch -a

Crear una rama desde una confirmación

$ git checkout -b <branch> <SHA1_OF_COMMIT>

Hice pull de / en la rama incorrecta

Esta es otra oportunidad de usar git reflog para ver dónde apuntó el HEAD antes del mal tirón.

(main) $ git reflog
ab7555f HEAD @ {0}: pull-wrong-branch: Fast-forward
c5bc55a HEAD @ {1}: checkout: checkout message goes here

Simplemente restablece tu rama al commit deseado:

$ git reset --hard c5bc55a

Hecho.

Quiero descartar confirmaciones locales para que mi rama sea la misma que la del servidor

Confirma que no ha enviado sus cambios al servidor.

git status debe mostrar cuántos commits tienes adelantado al origin:

(my-branch)$ git status
# On branch my-branch
# Your branch is ahead of 'origin/my-branch' by 2 commits.
#   (use "git push" to publish your local commits)
#

Una forma de reiniciar para hacer coincidir el origin (tener lo mismo que lo que está en el control remoto) es hacer esto:

(main) $ git reset --hard origin / my-branch

Hice commit a main en lugar de una nueva rama

Crea la nueva rama mientras permaneces en main:

(main) $ git branch my-branch

Restablece la rama main al commit anterior:

(main) $ git reset --hard HEAD ^

HEAD ^ es la abreviatura de HEAD ^ 1. Esto representa el primer padre de HEAD, del mismo modo HEAD ^ 2 representa el segundo padre del commit (las fusiones pueden tener 2 padres).

Ten en cuenta que HEAD ^ 2 ** no ** es lo mismo que HEAD ~ 2 (vea [este enlace] (http://www.paulboxley.com/blog/2011/06/git-caret-and-tilde) para más información).

Alternativamente, si no quieres usar HEAD ^, averigüe a qué hash de confirmación quieres establecer su rama principal (git log debería ser el truco). Luego reinicia a ese hash. git push se asegurará de que este cambio se refleje en su control remoto.

Por ejemplo, si el hash del commit en el que se supone que está su rama principal es a13b85e:

(main) $ git reset --hard a13b85e
HEAD is now at a13b85e

Verifique la nueva rama para continuar trabajando:

(main) $ git checkout my-branch

Quiero mantener todo el archivo de otro ref-ish

Supongamos que tienes un pico activo (ver nota), con cientos de cambios. Todo está funcionando. Ahora, te comprometes con otra rama para guardar ese trabajo:

(solución) $ git add -A && git commit -m "Agregando todos los cambios desde este pico en un gran compromiso."

Cuando desees colocarlo en una rama (tal vez función, tal vez develop), te interesa conservar archivos completos. Quieres dividir tu gran compromiso en otros más pequeños.

Digamos que tienes:

  • branch solution, con la solución para tu spike. Uno por delante de develop.
  • branch develop, donde desea agregar sus cambios.

Puedes resolverlo llevando los contenidos a tu rama:

(develop) $ git checkout solution - file1.txt

Esto obtendrá los contenidos de ese archivo en la 'solución' de la rama a su rama develop:

# On branch develop
# Your branch is up-to-date with 'origin/develop'.
# Changes to be committed:
#  (use "git reset HEAD <file>..." to unstage)
#
#        modified:   file1.txt

Entonces, haz un commit como de costumbre.

Nota: Las soluciones de Spike están hechas para analizar o resolver el problema. Estas soluciones se utilizan para la estimación y se descartan una vez que todos obtienen una visualización clara del problema. ~ [Wikipedia] (https://en.wikipedia.org/wiki/Extreme_programming_practices).

Realicé varios commits en una sola rama que debería estar en diferentes ramas

Digamos que estás en tu rama principal. Al ejecutar git log, verás que ha realizado dos commits:

(main) $ git log

commit e3851e817c451cc36f2e6f3049db528415e3c114
Author: Alex Lee <[email protected]>
Date:   Tue Jul 22 15:39:27 2014 -0400

    Bug #21 - Added CSRF protection

commit 5ea51731d150f7ddc4a365437931cd8be3bf3131
Author: Alex Lee <[email protected]>
Date:   Tue Jul 22 15:39:12 2014 -0400

    Bug #14 - Fixed spacing on title

commit a13b85e984171c6e2a1729bb061994525f626d14
Author: Aki Rose <[email protected]>
Date:   Tue Jul 21 01:12:48 2014 -0400

    First commit

Toma nota de nuestros hashes de confirmación para cada error (e3851e8 para # 21, 5ea5173 para # 14).

Primero, restablece la rama principal al commit correcto (a13b85e):

(main)$ git reset --hard a13b85e
HEAD is now at a13b85e

Ahora, puedes crear una nueva rama para la rama bug # 21:

(main) $ git checkout -b 21
(21) $

Ahora, * selecciona con precisión * el commit para el error # 21 en la parte superior de la rama. Eso significa que aplicarás ese commit, y solo ese commit, directamente sobre el HEAD que estés.

(21) $ git cherry-pick e3851e8

En este punto, existe la posibilidad de que haya conflictos. Consulta la sección ** Hubo conflictos ** (# conflicto de fusión) en la [sección interactiva de rebase más arriba] (# interactive-rebase) para saber cómo resolver conflictos.

Ahora creamos una nueva rama para el error # 14, también basado en el main

(21) $ git checkout main
(main) $ git checkout -b 14
(14) $

Y finalmente, vamos a seleccionar el compromiso para el error # 14:

(14) $ git cherry-pick 5ea5173

Quiero eliminar las ramas locales que se eliminaron en sentido ascendente

Una vez que fusiona una solicitud de extracción en GitHub, le da la opción de eliminar la rama fusionada en su fork. Si no tiene planeado seguir trabajando en la rama, es más limpio eliminar las copias locales de la rama para que no termine complicando su proceso de pago con muchas ramas obsoletas.

$ git fetch -p upstream

donde, 'ascendente' es el control remoto desde el que desea recuperar.

Accidentalmente borré mi rama

Si empujas regularmente hacia el control remoto, deberías estar seguro la mayor parte del tiempo. Pero aún así a veces puede terminar borrando sus ramaes. Digamos que creamos una rama y creamos un nuevo archivo:

(main)$ git checkout -b my-branch
(my-branch)$ git branch
(my-branch)$ touch foo.txt
(my-branch)$ ls
README.md foo.txt

Vamos a agregarlo y hacer el commit.

(my-branch)$ git add .
(my-branch)$ git commit -m 'foo.txt added'
(my-branch)$ foo.txt added
 1 files changed, 1 insertions(+)
 create mode 100644 foo.txt
(my-branch)$ git log

commit 4e3cd85a670ced7cc17a2b5d8d3d809ac88d5012
Author: siemiatj <[email protected]>
Date:   Wed Jul 30 00:34:10 2014 +0200

    foo.txt added

commit 69204cdf0acbab201619d95ad8295928e7f411d5
Author: Kate Hudson <[email protected]>
Date:   Tue Jul 29 13:14:46 2014 -0400

    Fixes #6: Force pushing after amending commits

Ahora estamos volviendo a "main" y "accidentalmente" eliminando nuestra rama.

(my-branch)$ git checkout main
Switched to branch 'main'
Your branch is up-to-date with 'origin/main'.
(main)$ git branch -D my-branch
Deleted branch my-branch (was 4e3cd85).
(main)$ echo oh noes, deleted my branch!
oh noes, deleted my branch!

En este punto, debe familiarizarse con 'reflog', un registrador actualizado. Almacena el historial de todas las acciones en el repositorio.

(main)$ git reflog
69204cd HEAD@{0}: checkout: moving from my-branch to main
4e3cd85 HEAD@{1}: commit: foo.txt added
69204cd HEAD@{2}: checkout: moving from main to my-branch

Como puede ver, hemos confirmado el hash de nuestra rama eliminada. Veamos si podemos restaurar nuestra rama eliminada.

(main)$ git checkout -b my-branch-help
Switched to a new branch 'my-branch-help'
(my-branch-help)$ git reset --hard 4e3cd85
HEAD is now at 4e3cd85 foo.txt added
(my-branch-help)$ ls
README.md foo.txt

Voila! Recuperamos nuestro archivo eliminado. git reflog también es útil cuando el rebase es terriblemente incorrecto.

Quiero eliminar una rama

Para eliminar una rama remota:

(main) $ git push origin --delete my-branch

También puedes hacer:

(main) $ git push origin: my-branch

Para eliminar una rama local:

(main) $ git branch -d my-branch

Para eliminar una rama local que * no * se ha fusionado con la rama actual o una cadena ascendente:

(main) $ git branch -D my-branch

Quiero eliminar varias ramas

Supongamos que quiere eliminar todas las ramas que comienzan con fix /:

(main) $ git rama | grep 'fix /' | xargs git branch -d

Quiero cambiar el nombre de una rama

Para cambiar el nombre de la rama actual (local):

(main) $ git branch -m new-name

Para cambiar el nombre de una rama diferente (local):

(main) $ git branch -m old-name new-name

Quiero hacer checkout en una rama remota en la que alguien más está trabajando

Primero, busca todas las ramas desde el control remoto:

(main)$ git fetch --all

Digamos que quieres hacer checkout a daves desde el repositorio remoto.

(main)$ git checkout --track origin/daves
Branch daves set up to track remote branch daves from origin.
Switched to a new branch 'daves'

(--track es la abreviatura de 'git checkout -b [branch] [remotename] / [branch]`)

Esto le dará una copia local de la rama daves, y cualquier actualización que se haya enviado también se mostrará de forma remota.

Quiero crear una nueva rama remota desde la actual local

$ git push <remote>

Si también desea establecer esa rama remota como cadena arriba para la actual, use lo siguiente:

$ git push -u <remote>

Con el modo upstream y el modo simple (predeterminado en Git 2.0) de la configuración push.default, el siguiente comando empujará la bifurcación actual con respecto a la bifurcación remota que se ha registrado previamente con -u :

$ git push

El comportamiento de los otros modos de git push se describe en el documento de push.default.

Quiero configurar una rama remota como upstream para una rama local

Puedes establecer una rama remota como ascendente para la sucursal local actual usando:

$ git branch --set-upstream-to [remotename]/[branch]
# or, using the shorthand:
$ git branch -u [remotename]/[branch]

Para establecer la rama remota ascendente para otra rama local:

$ git branch -u [remotename] / [branch] [local-branch]

Quiero configurar mi HEAD para rastrear la rama remota predeterminada

Al verificar tus ramas remotas, puedes ver en qué rama remota está rastreando el HEAD. En algunos casos, esta no es la rama deseada.

$ git branch -r
  origin/HEAD -> origin/gh-pages
  origin/main

Cambiar origin / HEAD para rastrear origin / main, puedes ejecutar este comando:

$ git remote set-head origin --auto
origin/HEAD set to main

Rebasing y Merging

Quiero deshacer rebase/merge

Es posible que hayas fusionado o rediseñado tu rama actual con una rama incorrecta, o que no puedas resolverlo o finalizar el proceso de rebase/merge. Git guarda el puntero original HEAD en una variable llamada ORIG_HEAD antes de realizar operaciones peligrosas, por lo que es sencillo recuperar la rama en el estado anterior al rebase/merge.

(my-branch)$ git reset --hard ORIG_HEAD

Hice rebase, pero no quiero forzar el push

Desafortunadamente, debes forzar el push, si deseas que esos cambios se reflejen en la rama remota. Esto se debe a que ha cambiado el historial. La rama remota no aceptará cambios a menos que fuerce la inserción. Esta es una de las principales razones por las que muchas personas usan un flujo de trabajo de merge, en lugar de un flujo de trabajo de reordenación: los equipos grandes pueden tener problemas con el impulso de los desarrolladores. Usa esto con precaución. Una forma más segura de utilizar rebase no es reflejar los cambios en la rama remota, sino hacer lo siguiente:

(main)$ git checkout my-branch
(my-branch)$ git rebase -i main
(my-branch)$ git checkout main
(main)$ git merge --ff-only my-branch

Para obtener más información, consulte [este thread SO] (https://stackoverflow.com/questions/11058312/how-can-i-use-git-rebase-without-requiring-a-forced-push).

Necesito combinar commits

Supongamos que estás trabajando en una rama que es / se convertirá en un pull request contra main. En el caso más simple, cuando todo lo que quiere hacer es combinar todos los commits en uno solo y no le importa cometer timestamps, puedes restablecer y volver a hacer el commit. Asegúrate de que la rama principal esté actualizada y de que se hayan confirmado todos los cambios, luego:

(my-branch)$ git reset --soft main
(my-branch)$ git commit -am "New awesome feature"

Si deseas más control y también conservar las marcas de tiempo, debe hacer algo que se llame un rebase interactivo:

(my-branch)$ git rebase -i main

Si no estás trabajando contra otra rama tendrás que volver a establecer una base relativa a tu HEAD. Si quieres aplastar las últimas 2 confirmaciones, por ejemplo, tendrás que volver a calcular contra HEAD ~ 2. Para los últimos 3, HEAD ~ 3, etc.

(main)$ git rebase -i HEAD~2

Después de ejecutar el comando de rebase interactivo, verás algo como esto en tu editor de texto:

pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
pick b729ad5 fixup
pick e3851e8 another fix

# Rebase 8074d12..b729ad5 onto 8074d12
#
# Commands:
#  p, pick = use commit
#  r, reword = use commit, but edit the commit message
#  e, edit = use commit, but stop for amending
#  s, squash = use commit, but meld into previous commit
#  f, fixup = like "squash", but discard this commit's log message
#  x, exec = run command (the rest of the line) using shell
#
# These lines can be re-ordered; they are executed from top to bottom.
#
# If you remove a line here THAT COMMIT WILL BE LOST.
#
# However, if you remove everything, the rebase will be aborted.
#
# Note that empty commits are commented out

Todas las líneas que comienzan con # son comentarios, no afectarán a tu rebase.

Reemplaza los comandos pick con cualquiera en la lista anterior, y también puedes eliminar commits eliminando las líneas correspondientes.

Por ejemplo, si deseas dejar el commit más antiguo (el primero) solo y combinar todos los siguientes commits con el segundo más antiguo, debes editar la letra junto a cada commit, excepto la primera y la segunda para decir f :

pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
f b729ad5 fixup
f e3851e8 another fix

Si deseas combinar estos commits y cambiar el nombre del commit, también debes agregar una r junto al segundo commit o simplemente usar s en lugar de f:

pick a9c8a1d Some refactoring
pick 01b2fd8 New awesome feature
s b729ad5 fixup
s e3851e8 another fix

A continuación, puedes cambiar el nombre del commit en el siguiente mensaje de texto que aparece.

Newer, awesomer features

# Please enter the commit message for your changes. Lines starting
# with '#' will be ignored, and an empty message aborts the commit.
# rebase in progress; onto 8074d12
# You are currently editing a commit while rebasing branch 'main' on '8074d12'.
#
# Changes to be committed:
#   modified:   README.md
#

Si todo tiene éxito, deberías ver algo como esto:

(main)$ Successfully rebased and updated refs/heads/main.

Estrategia de merge segura

--no-commit realiza el merge, pero simula que la combinación falló y no se confirma automáticamente, lo que le da al usuario la oportunidad de inspeccionar y modificar aún más el resultado de la combinación antes de realizar la tarea. no-ff mantiene la evidencia de que alguna vez existió una rama de características, manteniendo la historia del proyecto consistente.

(main)$ git merge --no-ff --no-commit my-branch

Necesito fusionar una rama en un solo commit

(main)$ git merge --squash my-branch

Quiero combinar solo los commits sin haber hecho push

A veces tiene varios commits en progreso que deseas combinar antes de hacer push. No deseas combinar accidentalmente ningún commit que ya haya sido pusheado porque otra persona ya haya realizado commits que les hagan referencia.

(main)$ git rebase -i @{u}

Esto hará una base de datos interactiva que enumera solo los commits que aún no has enviado, por lo que será seguro reordenar / arreglar / aplastar cualquier elemento de la lista.

Necesito abortar el merge

A veces, la fusión puede producir problemas en ciertos archivos, en esos casos podemos usar la opción abort para abortar el proceso actual de resolución de conflictos, y tratar de reconstruir el estado previo a la fusión.

(my-branch)$ git merge --abort

Este comando está disponible desde la versión de Git> = 1.7.4

Comprobar si se combinan todos los commits de un branch

Para comprobar si todos los commits de una rama se fusionan en otra, debe distinguir las cabeceras (o los commits) de esas ramas:

(main)$ git log --graph --left-right --cherry-pick --oneline HEAD...feature/120-on-scroll

Esto te dirá si hay commits en una pero no en la otra, y te dará una lista de las no compartidas entre las ramas. Otra opción es hacer esto:

(main)$ git log main ^feature/120-on-scroll --no-merges

Posibles problemas con rebase interactivos

La pantalla de edición de rebase dice 'noop'

Si estás viendo esto:

noop

Eso significa que estás tratando de volver a establecer una base contra una rama que está en un commit idéntico, o está delante de tu rama actual. Puedes probar:

  • asegurándote de que tu rama principal esté donde debería estar
  • rebase contra HEAD ~ 2 o anterior a su lugar

Hubo conflictos

Si no puedes completar correctamente el rebase, es posible que tengas que resolver conflictos.

Primero ejecuta git status para ver qué archivos tienen conflictos en ellos:

(my-branch)$ git status
On branch my-branch
Changes not staged for commit:
  (use "git add <file>..." to update what will be committed)
  (use "git checkout -- <file>..." to discard changes in working directory)

  both modified:   README.md

En este ejemplo, README.md tiene conflictos. Abre ese archivo y busca lo siguiente:

   <<<<<<< HEAD
   some code
   =========
   some code
   >>>>>>> new-commit

Tendrás que resolver las diferencias entre el código que se agregó en tu nuevo commit (en el ejemplo, todo desde la línea media hasta `new-commit ') y tu' HEAD '.

Si deseas conservar la versión del código de una rama, puedes usar --us o --theirs:

(main*)$ git checkout --ours README.md
  • Cuando haces merge, usa --ours para mantener los cambios de la rama local, o --theirs para mantener los cambios de la otra rama.
  • Cuando haces rebase, usa --theirs para mantener los cambios de la rama local, o --ours para mantener los cambios de la otra rama. Para obtener una explicación de este intercambio, consulte [esta nota en la documentación de Git] (https://git-scm.com/docs/git-rebase#git-rebase---merge).

Si las fusiones son más complicadas, puede usar un editor visual diff:

(main*)$ git mergetool -t opendiff

Después de haber resuelto todos los conflictos y probado el código, git add los archivos que has cambiado, y luego continúa el rebase con git rebase --continue

(my-branch)$ git add README.md
(my-branch)$ git rebase --continue

Si después de resolver todos los conflictos terminas con un árbol idéntico a lo que era antes del commit, necesitas git rebase --skip en su lugar.

Si en algún momento deseas detener todo el rebase y volver al estado original de tu rama, puedes hacer:

(my-branch)$ git rebase --abort

Stash

Usar stash en todos los cambios

Para esconder todas las ediciones de tu directorio de trabajo

$ git stash

Si también quiere esconder archivos sin seguimiento, use la opción -u.

$ git stash -u

Usar stash para archivos específicos

Para esconder solo un archivo de tu directorio de trabajo

$ git stash push working-directory-path/filename.ext

Para esconder varios archivos de tu directorio de trabajo

$ git stash push working-directory-path/filename1.ext working-directory-path/filename2.ext

Usar stash con un mensaje

$ git stash save <message>

Aplicar un stash específico de la lista

Primero revisa la lista de stash con mensaje usando

$ git stash list

Luego selecciona un stash específico de la lista usando

$ git stash apply "stash@{n}"

Aquí, 'n' indica la posición del stash en la pila. El stash más alto será la posición 0.

Búsqueda

Quiero encontra un string en algún commit

Para encontrar un determinada string que se introdujo en cualquier commit, puedes usar la siguiente estructura:

$ git log -S "string to find"

Parámetros comunes:

  • --source significa mostrar el nombre de la referencia dada en la línea de comando por la cual se llegó a cada commit.

  • --all significa comenzar desde cada rama.

  • --reverse imprime en orden inverso, significa que mostrará el primer commit que realizó el cambio.

Quiero buscar por autor / committer

Para encontrar todos los commits por autor / committer, puedes usar:

$ git log --author=<name or email>
$ git log --committer=<name or email>

Ten en cuenta que autor y committer no son lo mismo. El --autor es la persona que originalmente escribió el código; por otro lado, el --committer es la persona que subió el código en nombre del autor original.

Quiero enumerar commits que contienen archivos específicos

Para encontrar todos los commits que contienen un archivo específico, puedes usar:

$ git log -- <path to file>

Por lo general, debes especificar una ruta exacta, pero también puede usar comodines en la ruta y el nombre del archivo:

$ git log -- **/*.js

Al usar comodines, es útil informar --name-status para ver la lista de archivos comprometidos:

$ git log --name-status -- **/*.js

Encontrar una etiqueta donde se hace referencia a un commit

Para encontrar todas las etiquetas que contienen un commit específico:

$ git tag --contains <commitid>

Submódulos

Clonar todos los submódulos

$ git clone --recursive git://github.com/foo/bar.git

Si ya fue clonado

$ git submodule update --init --recursive

Remover un submódulo

Crear un submódulo es bastante simple, pero eliminarlos no. Los comandos que necesitas son:

$ git submodule deinit submodulename
$ git rm submodulename
$ git rm --cached submodulename
$ rm -rf .git/modules/submodulename

Objetos diversos

Restaurar un archivo eliminado

Primero encuentra el commit donde el archivo existió por última vez:

$ git rev-list -n 1 HEAD -- filename

Luego hazle checkout a ese archivo

git checkout deletingcommitid^ -- filename

Eliminar una etiqueta

$ git tag -d <tag_name>
$ git push <remote> :refs/tags/<tag_name>

Recuperar una etiqueta eliminada

Si deseas recuperar una etiqueta que ya fue eliminada, puede hacerlo siguiendo estos pasos: Primero, debe encontrar la etiqueta inalcanzable:

$ git fsck --unreachable | grep tag

Toma nota del hash de la etiqueta. Luego, restaura la etiqueta eliminada con la siguiente, haciendo uso de [git update-ref] (https://git-scm.com/docs/git-update-ref):

$ git update-ref refs/tags/<tag_name> <hash>

Tu etiqueta ahora debería haber sido restaurada.

Patch eliminado

Si alguien envió un pull request en GitHub, pero luego eliminó el fork original, no podrá clonar su repositorio ni usar git am como [.diff, .patch] (https://github.com / blog / 967-github-secrets) las URL no están disponibles. Pero puedes verificar el PR utilizando las [referencias especiales de GitHub] (https://gist.github.com/piscisaureus/3342247). Para recuperar el contenido de PR # 1 en una nueva rama llamada pr_1:

$ git fetch origin refs/pull/1/head:pr_1
From github.com:foo/bar
 * [new ref]         refs/pull/1/head -> pr_1

Exportar un repositorio como un archivo Zip

$ git archive --format zip --output /full/path/to/zipfile.zip main

Seguimiento de archivos

Quiero cambiar el uso de mayúsculas de un nombre de archivo, sin cambiar el contenido del archivo

(main)$ git mv --force myfile MyFile

Quiero sobrescribir los archivos locales cuando hago un git pull

(main)$ git fetch --all
(main)$ git reset --hard origin/main

Quiero eliminar un archivo de Git pero mantener el archivo

(main)$ git rm --cached log.txt

Quiero revertir un archivo a una revisión específica

Suponiendo que el hash del commit que deseas es c5f567:

(main)$ git checkout c5f567 -- file1/to/restore file2/to/restore

Si desea volver a los cambios realizados solo 1 commit antes de c5f567, pase el hash de confirmación como c5f567 ~ 1:

(main)$ git checkout c5f567~1 -- file1/to/restore file2/to/restore

Configuración

Quiero agregar alias para algunos comandos de Git

En OS X y Linux, tu archivo de configuración de git se almacena en ~ / .gitconfig. He agregado algunos alias de ejemplo que uso como accesos directos (y algunos de mis errores comunes) en la sección `[alias]` como se muestra a continuación:

[alias]
    a = add
    amend = commit --amend
    c = commit
    ca = commit --amend
    ci = commit -a
    co = checkout
    d = diff
    dc = diff --changed
    ds = diff --staged
    f = fetch
    loll = log --graph --decorate --pretty=oneline --abbrev-commit
    m = merge
    one = log --pretty=oneline
    outstanding = rebase -i @{u}
    s = status
    unpushed = log @{u}
    wc = whatchanged
    wip = rebase -i @{u}
    zap = fetch -p

Quiero agregar un directorio vacío a mi repositorio

¡No puedes! Git no es compatible con esto, pero hay un truco. Puede crear un archivo .gitignore en el directorio con los siguientes contenidos:

 # Ignore everything in this directory
 *
 # Except this file
 !.gitignore

Otra convención común es crear un archivo vacío en la carpeta, titulado .gitkeep.

$ mkdir mydir
$ touch mydir/.gitkeep

También puedes nombrar el archivo como .keep, en cuyo caso la segunda línea de arriba sería touch mydir / .keep

Quiero guardar en caché un nombre de usuario y contraseña para un repositorio

Es posible que tengas un repositorio que requiera autenticación. En ese caso, puedes guardar en caché un nombre de usuario y contraseña para que no tenga que ingresarlos en cada push / pull. Credential helper puede hacer esto por ti.

$ git config --global credential.helper cache
# Set git to use the credential memory cache
$ git config --global credential.helper 'cache --timeout=3600'
# Set the cache to timeout after 1 hour (setting is in seconds)

Quiero hacer que Git ignore los permisos y cambios en el modo de archivo

$ git config core.fileMode false

Si deseas que este sea el comportamiento predeterminado para los usuarios que han iniciado sesión, utilice:

$ git config --global core.fileMode false

No tengo idea de lo que hice mal

Entonces, estás jodido, "reiniciaste" algo, o fusionaste la rama incorrecta, o forzaste empujar y ahora no puedes encontrar tus commits. Sabes, en algún momento, estabas bien y quieres volver a un estado en el que estabas.

Para esto está hecho git reflog. reflog realiza un seguimiento de los cambios en la punta de una rama, incluso si esa sugerencia no está referenciada por una rama o una etiqueta. Básicamente, cada vez que HEAD cambia, se agrega una nueva entrada al reflog. Esto solo funciona para los repositorios locales, lamentablemente, y solo rastrea los movimientos (no los cambios a un archivo que no fueron grabados en ninguna parte, por ejemplo).

(main)$ git reflog
0a2e358 HEAD@{0}: reset: moving to HEAD~2
0254ea7 HEAD@{1}: checkout: moving from 2.2 to main
c10f740 HEAD@{2}: checkout: moving from main to 2.2

El reflog anterior muestra una salida desde main a la rama 2.2 y viceversa. A partir de ahí, hay un restablecimiento completo de un commit más antiguo. La última actividad se representa en la parte superior con la etiqueta 'HEAD @ {0} `.

Si resulta que retrocedió accidentalmente, el reflog contendrá el main de un commit apuntado a (0254ea7) antes de que accidentalmente soltara 2 commits.

$ git reset --hard 0254ea7

Usando git reset es posible cambiar el main al commit que era antes. Esto proporciona una red de seguridad en caso de que la historia se haya cambiado accidentalmente.

(copiado y editado desde [Fuente] (https://www.atlassian.com/git/tutorials/rewriting-history/git-reflog)).

Otros recursos

Libros

  • Pro Git - Excelente libro de Scott Chacon y Ben Straub sobre Git
  • Git Internals - Otro excelente libro de Scott Chacon sobre Git

Tutoriales

Scripts y herramientas

  • firstaidgit.io Una selección de búsqueda de las preguntas más frecuentes de Git
  • git-extra-commands - una colección de scripts extra útiles de Git
  • git-extras - Utilidades de GIT - resumen de repo, repl, población de registro de cambios, porcentajes de confirmación de autor y más
  • git-fire - git-fire es un plugin de Git que ayuda en caso de una emergencia al agregar todos los archivos actuales, comprometerse y empujar a un nuevo rama (para evitar conflictos de combinación).
  • git-tips - Consejos pequeños de Git
  • git-town - Soporte genérico de alto nivel de flujo de trabajo de Git! http://www.git-town.com

Clientes GUI

  • GitKraken - El cliente francamente lujoso de Git, para Windows, Mac y Linux
  • git-cola - otro cliente de Git para Windows y OS X
  • GitUp - Una interfaz gráfica de usuario nueva que tiene algunas formas muy dogmáticas de lidiar con las complicaciones de Git
  • gitx-dev - otro cliente gráfico de Git para OS X
  • Sourcetree - Simplicity se une a la potencia en una hermosa y gratuita GUI de Git. Para Windows y Mac.
  • Tower - cliente gráfico de Git para OS X (pago)
  • tig - interfaz de texto en modo terminal para Git
  • Magit - Interfaz para Git implementada como un paquete de Emacs.
  • GitExtensions: una extensión de shell, un plugin de Visual Studio 2010-2015 y una herramienta de repositorio de Git independiente.
  • Fork - un cliente de Git rápido y amigable para Mac (beta)
  • gmaster - un cliente de Git para Windows que tiene combinación de 3 vías, analizan refactores, diferencias semánticas y fusión (beta)
  • gitk - un cliente de Git para Linux para permitir una vista simple del estado de repos.