Guía Básica Git

Git es el sistema de control de versiones distribuidas de código abierto que facilita las actividades de GitHub en su computadora portátil o escritorio. Esta hoja de trucos resume las instrucciones de línea de comando de Git utilizadas comúnmente para referencia rápida.

• Guía Básica Git

  • CONFIGURACIONES INICIALES
  • INICIALIZAR REPOSITORIO
  • AGREGAR ORIGEN DE REPOSITORIO
  • AGREGAR, MODIFICAR Y CONFIRMAR CAMBIOS
  • HISTORIAL DE COMMITS
  • VIAJES EN EL TIEMPO
  • CAMBIAR NOMBRES DE ARCHIVOS CON GIT
  • IGNORANDO ARCHIVO (.gitignore)
  • RAMAS
  • TAGS Y ETIQUETAS
  • GIT STASH
  • EMPUJANDO LOS CAMBIOS
  • GIT PULL Y GIT FETCH
  • ERROR AL AGREGAR ARCHIVOS

CONFIGURACIONES INICIALES

Para más información puedes ver la documentación aquí.

Configura la información del usuario para todos los repositorios locales.

Establece el nombre que desea adjuntar a sus commits.

xxxxxxxxxx
git config --global user.name "nombre_usuario"

Establece el correo electrónico que desea adjuntar a sus commits.

xxxxxxxxxx
git config --global user.email "correo_electronico"

INICIALIZAR REPOSITORIO

Inicializa un nuevo repositorio en el directorio donde se encuentre ubicado o uno con un nombre específico.

xxxxxxxxxx
git init

Descarga un proyecto y con él todo su historial de versiones.

xxxxxxxxxx
git clone [url]

Clonar un proyecto con un nombre alternativo

xxxxxxxxxx
git clone git://github.com/schacon/grit.git my_nuevo_proyecto

AGREGAR ORIGEN DE REPOSITORIO

Existen dos formas para agregar el origen de un repositorio.

1. Por medio de https:

xxxxxxxxxx
git remote add origin https://github.com/nombre/hold1.git

2. Por medio de ssh:

xxxxxxxxxx
git remote add origin git@github.com:nombre/hold1.git

Para ver una descripción de la configuración global puede utilizar:

xxxxxxxxxx
git config --global -l

Ver los repositorios remotos configurados.

xxxxxxxxxx
git remote -v

Si desea cambiar el repositorio remoto, antes debe quitar los que ya tiene inicializados esto lo puede realizar con el comando.

xxxxxxxxxx
git remote rm origin

AGREGAR, MODIFICAR Y CONFIRMAR CAMBIOS

Ver las ediciones, cambios.

xxxxxxxxxx
git status

Otra forma de ver el estado.

xxxxxxxxxx
git status -s

Pero también podemos ver más detalles del estado.

xxxxxxxxxx
git status -s -b

En caso existan archivos por agregar, hay que agregarlos a la cola de archivos para comprometer. Este es el “staging area” o área de presentación. Es importante agregar archivos aca, previo a hacer un commit. Aquí agregamos todo, esto lo hacemos con los siguientes comandos y las diferentes opciones.

Este comando agrega todos los archivos modificados.

xxxxxxxxxx
git add .

También podemos agregar archivos individualmente.

xxxxxxxxxx
git add nombre_archivo

Podemos agregar la cantidad de archivos que queramos con determinada extensión, esto aplica para los archivos en el mismo directorio.

xxxxxxxxxx
git add *.py

Para agregar todos los archivos con especifica extensión no importando el directorio en el que se encuentren utilizamos lo siguiente.

xxxxxxxxxx
git add "*.js"

Agregar todos los archivos de un especifico directorio.

xxxxxxxxxx
git add public/

Agregar todos los archivos que hayan sido modificados.

xxxxxxxxxx
git add -A

Excluir un archivo del stage.

xxxxxxxxxx
git reset *.json

Agregar todos los archivos, se parece al comando **git add .**

xxxxxxxxxx
git add --all

Si no sabe cuáles cambios han sido agregados al área de (add .) y desea ver cuales son las diferencias existentes en el área de presentación y los archivos que usted ha trabajado, entonces use el siguiente comando que muestra las diferencias.

xxxxxxxxxx
git diff

Luego agregados todos los archivos, podemos comprometerlos, la bandera -a (para agregar archivos con cambios y quitar los archivos borrados del índice local) y -m (de mensaje) agregando un comentario entre comillas que sirva de referencia.

xxxxxxxxxx
git commit -am "Mi Primer Commit"ogit commit -m "Mi Primer Commit" (Recomendado)ogit commit

Si solamente utilizar el comando git commit se abrirá un editor vim allí puedes editar tu mensaje.

Si por alguna razón cometes un error en el mensaje del commit, no hay problema esto se puede resolver con el siguiente comando que permite modificar el mensaje del commit.

xxxxxxxxxx
git commit --amend -m "Mensaje Corregido"

HISTORIAL DE COMMITS

Para ver el listado de commits.

xxxxxxxxxx
git log

Ver una descripción resumida de los commits.

xxxxxxxxxx
git log --oneline

Una descripción más detallada.

xxxxxxxxxx
git log --oneline --decorate --all --graph

Si queremos ver el log aunque hayamos realizado unreset --hard

xxxxxxxxxx
git reflog

VIAJES EN EL TIEMPO

Restaurar hacia el último cambio para hacer un nuevo commit corregido.

xxxxxxxxxx
git reset --soft HEAD^

Si queremos regresar hacia un punto en específico del historial de cambios en el repositorio podemos utilizar.

xxxxxxxxxx
git reset --mixed [número-hash]

Esta opción restaura hacia determinado commit, pero aún mantiene los archivos que hayamos estado trabajando después de ese commit.

La forma recomenda a utilizar es:

xxxxxxxxxx
git reset --hard [número-hash]

Esta opción nos permite restaurar hacia un punto en específico, descartando todos los cambios que hayamos hecho después de ese commit.

Para recuperar los últimos cambios realizados tras un posible error o pérdida de código puede ejecutar lo siguiente comando, este permite recuperar la información del último commit registrado.

xxxxxxxxxx
git checkout -- .

Si desea recuperar los últimos cambios registrados de un archivo en especifico.

xxxxxxxxxx
git checkout -- nombre_archivo

CAMBIAR NOMBRES DE ARCHIVOS CON GIT

Cuando cambiamos el nombre de un archivo manualmente, git puede detectar como si fuera un archivo nuevo, para evitar esto utilizamos lo siguiente:

xxxxxxxxxx
git mv nombre_script.py nombre_nuevo_script.py

Esto permite que git lleve el registro sobre el mismo archivo y que únicamente detecte que se renombro.

Otra recomendación para cuando se elimina un archivo y para que git lleve un correcto registro podemos hacer los siguiente después de eliminar los n archivos.

xxxxxxxxxx
git add -u
git add -A

IGNORANDO ARCHIVO (.gitignore)

Si deseamos que git no reconozca ciertos archivos o carpetas, solamente debemos crear un nuevo archivo llamado .gitignore en la raíz del proyecto, donde en cada línea podemos ir agregando que archivos queremos ignorar. Ejemplo:

xxxxxxxxxx
*.DS_Store
*.pyc
*.egg-info
*.swp
tags/
mi_proyecto/docs/

RAMAS

Crear una rama.

xxxxxxxxxx
git branch nombre_rama

O puede utilizar el siguiente comando que permite crear una rama y switchear a la misma.

xxxxxxxxxx
git checkout -b nombre_rama

Ver listado de ramas y listado completo.

xxxxxxxxxx
git branchogit branch -a

Cambiar de rama.

xxxxxxxxxx
git checkout nombre_rama

Ver diferencias entre ramas. En este ejemplo, es la diferencia entre la rama nueva y la rama master.

xxxxxxxxxx
git diff rama_nueva master

Fusionar ramas, esto se debe hacer desde la rama master.

xxxxxxxxxx
git merge nombre_rama

Eliminar una rama.

xxxxxxxxxx
git branch -d nombre_rama

Eliminar rama de forma forzada.

xxxxxxxxxx
git branch -D nombre_rama

Después de haber eliminado las ramas locamente puede limpiar el registro de nuevo, para que ya no aparezcan en el repositorio remoto, esto es opcional.

xxxxxxxxxx
git remote prune origin

TAGS Y ETIQUETAS

Los tags, etiquetas nos permiten crear descripciones para ciertos releases, por ejemplo para una versión de aplicación.

Crear un tag.

xxxxxxxxxx
git tag release-v1

Ver el listado de tags.

xxxxxxxxxx
git tag

Eliminar un tag.

xxxxxxxxxx
git tag -d nombre-tag

Forma Correcta para crear un release (-a = anotación).

xxxxxxxxxx
git tag -a v1.0.0 -m "Mensaje descriptivo de la versión"

Crear un tag o release para cualquier punto en el historial de nuestra proyecto.

xxxxxxxxxx
git tag -a v1.0.0 [numero-hash] -m "Mensaje"

Ejemplo:

xxxxxxxxxx
git tag -a v1.0.0 ca82a6d -m "Versión Producción"

Ver informacion sobre un tag.

xxxxxxxxxx
git tag show nombre_tag

GIT STASH

Git stash nos permite dejar lo que estamos trabajando en un punto, para enfocarnos en otro punto para luego recuperar lo que no terminamos.

xxxxxxxxxx
git stashogit stash save

Agregando mensajes a los stash, ya podemos tener más de un stash.

xxxxxxxxxx
git stash save "Mensaje"

Ver informacion de los stash.

xxxxxxxxxx
git stash list
​
git stash list --stat
​
git stash show

Recuperar un stash, esto extrae el último stash registrado con sus respectivos datos, cuando se ejecuta recupera el último stash y lo elimina, como si fuera de una pila.

xxxxxxxxxx
git stash pop

Tambien podemos utilizar apply.

xxxxxxxxxx
git stash apply
​
o
​
git stash apply [hash]

Si ya no vamos a utilizar un stash, hay que eliminarlo! Después de esto hay que verificarlo viendo el listado usando cualquiera de los comandos anteriores.

xxxxxxxxxx
git stash drop
​
o
​
git stash drop [hash]

EMPUJANDO LOS CAMBIOS

Ahora empujemos los cambios a nuestro repositorio en GitHub, esto lo hacemos con:

xxxxxxxxxx
git push -u origin master

La bandera -u nos permite indicar a que rama queremos hacer el push, para que la proxima vez podamos solamente utilizar

xxxxxxxxxx
git push

o bien puedes utilizar.

xxxxxxxxxx
git push origin master

Hacer Push de Tags

xxxxxxxxxx
git push --tags

GIT PULL Y GIT FETCH

Git pull nos permite sincronizar los cambios remotos con los cambios locales, cuando se utiliza git pull este automaticamente hacer merge los cambios remotos con los datos que tengamos en local.

xxxxxxxxxx
git pull origin master
​
o
​
git pull
​
y en caso no funcionen los comandos anteriores
​
git pull --all

Git Fetch nos permite actualizar nuestro repositorio local con los cambios realizados en el repositorio remoto.

xxxxxxxxxx
git fetch

Para ver los cambios, actualizaciones de un repositorio forkeado de algun compañero podemos utilizar.

xxxxxxxxxx
git remote add upstream <repositorio_original>
​
git fetch upstream

ERROR AL AGREGAR ARCHIVOS

Puede ocurrir el error que git no nos permita agregar archivos, esto lo podemos solucionar con.

xxxxxxxxxx
rm -f ./.git/index.lock

Esto eliminará de forma forzada el archivo index.lock lo cual provoca el error.