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
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.
git config --global user.name "nombre_usuario"
Establece el correo electrónico que desea adjuntar a sus commits.
git config --global user.email "correo_electronico"
Inicializa un nuevo repositorio en el directorio donde se encuentre ubicado o uno con un nombre específico.
git init
Descarga un proyecto y con él todo su historial de versiones.
git clone [url]
Clonar un proyecto con un nombre alternativo
git clone git://github.com/schacon/grit.git my_nuevo_proyecto
Existen dos formas para agregar el origen de un repositorio.
- Por medio de https:
git remote add origin https://github.com/nombre/hold1.git
- Por medio de ssh:
git remote add origin [email protected]:nombre/hold1.git
Para ver una descripción de la configuración global puede utilizar:
git config --global -l
Ver los repositorios remotos configurados.
git remote -v
Si desea cambiar el repositorio remoto, antes debe quitar los que ya tiene inicializados esto lo puede realizar con el comando.
git remote rm origin
Ver las ediciones, cambios.
git status
Otra forma de ver el estado.
git status -s
Pero también podemos ver más detalles del estado.
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.
git add .
También podemos agregar archivos individualmente.
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.
git add *.py
Para agregar todos los archivos con especifica extensión no importando el directorio en el que se encuentren utilizamos lo siguiente.
git add "*.js"
Agregar todos los archivos de un especifico directorio.
git add public/
Agregar todos los archivos que hayan sido modificados.
git add -A
Excluir un archivo del stage.
git reset *.json
Agregar todos los archivos, se parece al comando **git add .**
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.
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.
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.
git commit --amend -m "Mensaje Corregido"
Para ver el listado de commits.
git log
Ver una descripción resumida de los commits.
git log --oneline
Una descripción más detallada.
git log --oneline --decorate --all --graph
Si queremos ver el log aunque hayamos realizado un reset --hard
git reflog
Restaurar hacia el último cambio para hacer un nuevo commit corregido.
git reset --soft HEAD^
Si queremos regresar hacia un punto en específico del historial de cambios en el repositorio podemos utilizar.
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:
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.
git checkout -- .
Si desea recuperar los últimos cambios registrados de un archivo en especifico.
git checkout -- nombre_archivo
Cuando cambiamos el nombre de un archivo manualmente, git puede detectar como si fuera un archivo nuevo, para evitar esto utilizamos lo siguiente:
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.
git add -u
git add -A
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:
*.DS_Store
*.pyc
*.egg-info
*.swp
tags/
mi_proyecto/docs/
Crear una rama.
git branch nombre_rama
O puede utilizar el siguiente comando que permite crear una rama y switchear a la misma.
git checkout -b nombre_rama
Ver listado de ramas y listado completo.
git branchogit branch -a
Cambiar de rama.
git checkout nombre_rama
Ver diferencias entre ramas. En este ejemplo, es la diferencia entre la rama nueva y la rama master.
git diff rama_nueva master
Fusionar ramas, esto se debe hacer desde la rama master.
git merge nombre_rama
Eliminar una rama.
git branch -d nombre_rama
Eliminar rama de forma forzada.
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.
git remote prune origin
Los tags, etiquetas nos permiten crear descripciones para ciertos releases, por ejemplo para una versión de aplicación.
Crear un tag.
git tag release-v1
Ver el listado de tags.
git tag
Eliminar un tag.
git tag -d nombre-tag
Forma Correcta para crear un release (-a = anotación).
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.
git tag -a v1.0.0 [numero-hash] -m "Mensaje"
Ejemplo:
git tag -a v1.0.0 ca82a6d -m "Versión Producción"
Ver informacion sobre un tag.
git tag show nombre_tag
Git stash nos permite dejar lo que estamos trabajando en un punto, para enfocarnos en otro punto para luego recuperar lo que no terminamos.
git stashogit stash save
Agregando mensajes a los stash, ya podemos tener más de un stash.
git stash save "Mensaje"
Ver informacion de los stash.
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.
git stash pop
Tambien podemos utilizar apply.
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.
git stash drop
o
git stash drop [hash]
Ahora empujemos los cambios a nuestro repositorio en GitHub, esto lo hacemos con:
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
git push
o bien puedes utilizar.
git push origin master
Hacer Push de Tags
git push --tags
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.
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.
git fetch
Para ver los cambios, actualizaciones de un repositorio forkeado de algun compañero podemos utilizar.
git remote add upstream <repositorio_original>
git fetch upstream
Puede ocurrir el error que git no nos permita agregar archivos, esto lo podemos solucionar con.
rm -f ./.git/index.lock
Esto eliminará de forma forzada el archivo index.lock lo cual provoca el error.