En WSL o Linux debes realizar lo siguiente en tu terminal:
sudo apt install gitgit --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.
Ingresa tu correo electrónico. Si tienes correo institucional, considéralo: te da
acceso al GitHub Student Developer Pack.
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.
Verifica el correo con el código que te llega.
Activa la autenticación en dos pasos cuando te la ofrezca. GitHub la exige
para todas las cuentas.
Falta captura
Pantalla de registro de GitHub.
Guardar la imagen en content/img/github-registro.png y reemplazar este bloque por:
¿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.
Abre VSCode.
Haz clic en el ícono de cuentas, abajo a la izquierda (la silueta de una
persona).
Elige Sign in with GitHub.
Se abrirá el navegador pidiendo autorización. Presiona Authorize.
Vuelve a VSCode: el ícono de cuentas ahora muestra tu usuario de GitHub.
Falta captura
Panel de cuentas de VSCode con la opción “Sign in with GitHub”.
Guardar la imagen en content/img/vscode-github.png y reemplazar este bloque por:
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
Estando conectado a GitHub, presiona el botón + arriba a la derecha y elige
New repository.
Escribe el nombre del repositorio siguiendo las
buenas prácticas de nombres: minúsculas, sin
espacios, sin tildes.
Elige si será público o privado. Si lo haces privado, recuerda invitar al
profesor.
Marca Add a README file, así el repositorio no queda vacío y se puede clonar
de inmediato.
Presiona Create repository.
Falta captura
Formulario “New repository” de GitHub.
Guardar la imagen en content/img/github-nuevo-repo.png y reemplazar este bloque por:
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:
https://github.com/tu-usuario/tu-proyecto.git
Falta captura
Botón “Code” desplegado, mostrando la pestaña HTTPS y el botón de copiar.
Guardar la imagen en content/img/github-url-https.png y reemplazar este bloque por:
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.gitcd tu-proyecto
Esto crea una carpeta con el nombre del repositorio. Ya dentro, puedes abrirla en
VSCode:
code .
Falta captura
Terminal mostrando el resultado de git clone.
Guardar la imagen en content/img/git-clone.png y reemplazar este bloque por:
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 — Si ya conectaste VSCode con GitHub (paso anterior), VSCode
administra las credenciales automáticamente y no te pedirá nada.
Alternativa — Generar un Personal Access Token en GitHub
(Settings → Developer settings → Personal access tokens) y usarlo 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.