2. Instalación y cuenta

Instalación de Git

En WSL o Linux debes realizar lo siguiente en tu terminal:

sudo apt install git
git --version

El segundo comando es para verificar: debe responder con el número de versión instalada.

Son dos guiones, no uno largo

git --version, no git –version. Si copias comandos desde un documento de Word, el autocorrector convierte -- en un guion largo – y Git responderá unknown option. Lo mismo aplica a todos los comandos de esta página.

Configuración inicial

git config --global user.name "tu nombre de usuario"
git config --global user.email "tu email"

Estos pasos de configuración solamente es necesario que se realicen una vez, no en cada proyecto. La opción --global guarda la configuración para tu usuario completo del sistema.

Es user.email, no user.mail

user.mail no es una clave que Git reconozca. El comando no da error, pero Git nunca la lee: tus commits quedarían sin correo asociado y GitHub no los vincularía a tu cuenta. Verifica con:

git config --global --list

Usa el mismo correo de tu cuenta de GitHub

Es lo que permite que GitHub reconozca tus commits como tuyos y los muestre con tu nombre y tu foto.

Crea tu cuenta de GitHub

1. Entra a https://github.com y presiona Sign up.
2. Ingresa tu correo electrónico. Si tienes correo institucional, considéralo: te da acceso al GitHub Student Developer Pack.
3. Crea una contraseña y elige tu nombre de usuario. Este nombre aparecerá en la URL de todos tus repositorios (github.com/tu-usuario/tu-proyecto), así que elige algo sobrio: lo vas a usar profesionalmente después del curso.
4. Verifica el correo con el código que te llega.
5. Activa la autenticación en dos pasos cuando te la ofrezca. GitHub la exige para todas las cuentas.

¿Cómo conectar Git con VSCode?

VSCode trae integración con Git incorporada: no necesitas instalar nada aparte. Lo que sí hay que hacer es autorizar tu cuenta de GitHub, para que pueda subir cambios sin pedirte la contraseña cada vez.

1. Abre VSCode.
2. Haz clic en el ícono de cuentas, abajo a la izquierda (la silueta de una persona).
3. Elige Sign in with GitHub.
4. Se abrirá el navegador pidiendo autorización. Presiona Authorize.
5. Vuelve a VSCode: el ícono de cuentas ahora muestra tu usuario de GitHub.

El menú que se abre es el de la captura: la opción que te interesa es la que inicia sesión con GitHub. Si ya habías entrado, el ícono muestra un número y tu usuario.

El panel de control de código fuente

El tercer ícono de la barra lateral (las tres ramas conectadas, o Ctrl + Shift + G) muestra los archivos modificados y permite hacer commit sin usar la terminal. Es cómodo, pero en este curso los comandos se aprenden en la terminal: es lo que vas a encontrar en cualquier servidor, donde no hay interfaz gráfica.

Creación de repositorio y clonación

1. Crear el repositorio en GitHub

1. Estando conectado a GitHub, presiona el botón + arriba a la derecha y elige New repository.
2. Escribe el nombre del repositorio siguiendo las buenas prácticas de nombres: minúsculas, sin espacios, sin tildes.
3. Elige si será público o privado. Si lo haces privado, recuerda invitar al profesor.
4. Marca Add a README file, así el repositorio no queda vacío y se puede clonar de inmediato.
5. Presiona Create repository.

El botón New, en la columna izquierda de tu página de inicio de GitHub:

Y el formulario que se abre:

Los tres campos que importan

Repository name (el nombre, en minúsculas y sin espacios), Choose visibility (público o privado) y Add README, que conviene dejar en On para que el repositorio no quede vacío. Lo demás puedes dejarlo como viene.

2. Copiar la URL HTTPS

Dentro del repositorio recién creado, presiona el botón verde Code. Se abrirá un desplegable con tres pestañas: HTTPS, SSH y GitHub CLI.

Asegúrate de estar en la pestaña HTTPS y copia la dirección con el ícono de copiar. Debe terminar en .git:

Ejemplo de HTTPS

https://github.com/tu-usuario/tu-proyecto.git

Si el repositorio quedó vacío verás esta pantalla

Cuando creas el repositorio sin marcar Add README, GitHub no muestra el botón Code sino la pantalla Quick setup de la captura, con las mismas pestañas HTTPS / SSH y el mismo botón de copiar. La URL es la misma.

HTTPS, no SSH

La pestaña SSH entrega una dirección que empieza con git@github.com:. Esa requiere configurar claves criptográficas, que no veremos en el curso. Si te aparece un error de permisos al hacer push, revisa que hayas copiado la URL desde la pestaña correcta.

3. Clonar el repositorio

Clonar es descargar el repositorio a tu computador, con todo su historial. En la terminal, ubícate donde quieras guardar el proyecto y ejecuta:

cd ~
git clone https://github.com/tu-usuario/tu-proyecto.git
cd tu-proyecto

Esto crea una carpeta con el nombre del repositorio. Ya dentro, puedes abrirla en VSCode:

code .

"Pareces haber clonado un repositorio sin contenido"

Ese aviso aparece cuando el repositorio se creó vacío, sin README. No es un error: la carpeta y el .git quedaron creados igual, y en cuanto hagas tu primer commit desaparece.

Clona una sola vez por proyecto

git clone se usa al principio y nunca más. Para traer cambios posteriores se usa git pull, que verás en la página siguiente.

La primera vez que hagas push

Git te pedirá tus credenciales. No uses tu contraseña de GitHub: no funciona desde 2021. Hay dos caminos:

• Recomendado (conectar VSCode con GitHub, como en el paso anterior). VSCode administra las credenciales automáticamente y no te pedirá nada.
• Alternativa (un Personal Access Token). Se genera en GitHub, en Settings → Developer settings → Personal access tokens, y se usa en lugar de la contraseña.

Checkpoint

Intenta responder antes de desplegar cada pregunta.

¿Qué dos comandos de configuración se ejecutan una sola vez y para qué sirven?

git config --global user.name "tu nombre de usuario"
git config --global user.email "tu email"

Definen con qué nombre y correo quedará firmado cada commit que hagas. La opción --global los guarda para tu usuario completo del sistema, por eso no hay que repetirlos en cada proyecto.

¿Por qué user.mail no funciona?

Porque no es una clave que Git reconozca; la correcta es user.email. Lo traicionero es que el comando no da error: guarda la configuración, pero Git nunca la lee, tus commits quedan sin correo y GitHub no los vincula a tu cuenta. Se revisa con git config --global --list.

¿Qué diferencia hay entre la URL HTTPS y la SSH de un repositorio?

La HTTPS empieza con https://github.com/… y se autentica con tus credenciales o un token; es la que usaremos en el curso. La SSH empieza con git@github.com:… y requiere configurar claves criptográficas, que no veremos. Si te da un error de permisos al hacer push, revisa cuál copiaste.

¿Qué hace git clone y cuántas veces se usa por proyecto?

Descarga el repositorio completo a tu computador, con todo su historial, y crea una carpeta con su nombre. Se usa una sola vez por proyecto: para traer cambios posteriores se usa git pull.

¿Por qué no puedes usar tu contraseña de GitHub al hacer push?

Porque GitHub la deshabilitó para operaciones de Git en 2021. Hay dos caminos: que VSCode administre las credenciales (si ya conectaste tu cuenta, que es lo recomendado) o generar un Personal Access Token en Settings → Developer settings → Personal access tokens y usarlo en lugar de la contraseña.

¿Qué pasa si eliges el nombre de usuario de GitHub a la ligera?

Que aparece en la URL de todos tus repositorios (github.com/tu-usuario/tu-proyecto) y es el que vas a compartir en un currículum o en una postulación. Conviene elegir algo sobrio desde el principio: lo vas a usar profesionalmente mucho después de este curso.