Git y GitHub › Tema 2

Los comandos básicos

Con cinco comandos se hace casi todo el trabajo de cada día. Esta es la tabla que tienes que tener a mano. Después, cómo conectar tu proyecto con GitHub y trabajar desde dos ordenadores.

Los cinco imprescindibles#

origin es tu repositorio de GitHub y main, la rama principal (las ramas, en el tema avanzado).

El ciclo de cada día#

git pull origin main                      # 1. antes de empezar
# ... trabajas en tu código ...
git add .                                 # 2. preparar
git commit -m "Añade el menú lateral"     # 3. guardar
git push origin main                      # 4. subir

Empezar un proyecto con GitHub#

GitHub guarda una copia de tu repositorio en la nube: una copia de seguridad, y la forma de trabajar un día en el aula y otro en casa con el mismo proyecto. Para conectar un proyecto con GitHub hay dos caminos, según cómo empieces.

Si el proyecto aún no existe: clonar#

1. En GitHub, pulsa New (o el + de arriba a la derecha → New repository).
2. Escribe el nombre, elige Public o Private y marca Add a README file.
3. Pulsa Create repository, y después el botón verde Code: copia la dirección que empieza por https://.
4. En la terminal, en la carpeta donde quieras el proyecto:

git clone https://github.com/ana/mi-proyecto.git

Se crea la carpeta mi-proyecto, ya conectada con GitHub. Ábrela en VS Code y a trabajar: pull, add, commit y push funcionan desde el primer momento.

Si ya tienes el proyecto en tu ordenador: conectarlo#

1. En GitHub, crea el repositorio como antes, pero sin marcar Add a README file: tiene que estar vacío.
2. En la terminal, dentro de la carpeta de tu proyecto:

git init
git add .
git commit -m "Primer commit"
git remote add origin https://github.com/ana/mi-proyecto.git
git push -u origin main

Bajar y subir: pull, push y fetch#

Trabajar en dos ordenadores#

El caso típico: trabajas en el aula, subes, y en casa sigues donde lo dejaste.

Si se te olvida el pull del principio y GitHub tiene commits que tú no, el push se rechaza:

 ! [rejected]        main -> main (fetch first)
error: failed to push some refs to 'https://github.com/ana/mi-proyecto.git'
hint: Updates were rejected because the remote contains work that you do not
hint: have locally. This is usually caused by another repository pushing to
hint: the same ref. If you want to integrate the remote changes, use
hint: 'git pull' before pushing again.

No se ha perdido nada. La solución es la que dice el propio mensaje: git pull origin main y otra vez git push origin main. Si los dos ordenadores cambiaron las mismas líneas del mismo archivo, el pull avisará de un conflicto: lo tienes en el tema avanzado.

Otros comandos útiles#

Donde pone <url> o <archivo>, se escribe su valor, sin los < >: git restore App.java.

Así se ve en la terminal#

Un proyecto nuevo con un App.java. Primero, git status avisa de que hay un archivo que Git todavía no vigila:

git status

On branch main

No commits yet

Untracked files:
  (use "git add <file>..." to include in what will be committed)
	App.java

nothing added to commit but untracked files present (use "git add" to track)

Se prepara y se guarda:

git add .
git commit -m "Primer commit"

[main (root-commit) e8b9f0f] Primer commit
 1 file changed, 1 insertion(+)
 create mode 100644 App.java

e8b9f0f es el código del commit: cada uno tiene el suyo. Y si no queda nada por guardar, git status lo dice así:

On branch main
Your branch is up to date with 'origin/main'.

nothing to commit, working tree clean

Buenos mensajes de commit#

El mensaje es para tu yo del futuro (y para tu equipo): tiene que decir qué cambiaste.

Desde VS Code#

VS Code tiene todo esto en la pestaña Control de código fuente (el icono de las ramitas, a la izquierda, o Ctrl + Shift + G):

Errores frecuentes#