Módulo 2: Configuración inicial de Git

Unidad: GIT-02
Público: alumnado de DAW, DAM, ASIR y grados de informática.
Itinerario: bloque 0, Arranque; antes de crear el primer repositorio.
Prerrequisitos: Git instalado y terminal básica.
Objetivo: configurar y comprobar la identidad que Git incluirá en los commits, además de distinguir configuración global y local.
Fuente técnica: documentación oficial de git config.
Encaje curricular: contenido transversal; debe vincularse a un módulo concreto solo tras comprobar la programación del centro.

Qué se configura y por qué

Cada commit guarda una autoría: nombre y correo electrónico. Git necesita esos datos antes de crear commits.

La configuración puede estar en varios ámbitos:

Ámbito Afecta a Uso habitual
--system Todos los usuarios del equipo Administración del sistema
--global Todos tus repositorios Identidad personal habitual
--local Solo el repositorio actual Proyecto con identidad o normas específicas

La configuración local tiene prioridad sobre la global. La configuración global solo guarda preferencias de Git para la cuenta de usuario; la demostración posterior de configuración local sí modifica .git/config del repositorio de práctica. Ningún paso modifica un remoto.

Demostración práctica

Comprueba primero que Git está instalado:

git --version

Salida esperada, con una versión que puede variar:

git version 2.x.x

Configura tu identidad global. Sustituye los valores por los tuyos:

git config --global user.name "Nombre Apellido"
git config --global user.email "nombre@ejemplo.com"

En macOS y Linux, Git suele guardar esta configuración en ~/.gitconfig; en Windows, en el archivo global equivalente de tu perfil. No necesitas editarlo a mano.

Comprueba los valores:

git config --global --get user.name
git config --global --get user.email

Salida esperada:

Nombre Apellido
nombre@ejemplo.com

Define también el nombre inicial de las ramas nuevas:

git config --global init.defaultBranch main

Compruébalo:

git config --global --get init.defaultBranch

Salida esperada:

main

Para saber de qué archivo procede cada valor:

git config --list --show-origin

La salida incluirá líneas similares a esta:

file:/ruta/a/.gitconfig	user.name=Nombre Apellido
file:/ruta/a/.gitconfig	user.email=nombre@ejemplo.com
file:/ruta/a/.gitconfig	init.defaultbranch=main

Configuración local: una excepción por proyecto

Cuando ya exista un repositorio, puedes establecer una identidad distinta solo para ese proyecto:

git config user.email "nombre@centro.educacion"
git config --get user.email

Al omitir --global, Git escribe el valor en la configuración local del repositorio (.git/config). Ese valor prevalece en ese proyecto, pero no modifica tu configuración general.

Para volver a usar el correo global en ese repositorio:

git config --unset user.email

Configuración opcional

Si quieres que Git abra los mensajes de commit con VS Code:

git config --global core.editor "code --wait"

Solo úsalo si el comando code está disponible en tu terminal. Esta preferencia no cambia archivos del proyecto ni commits existentes.

Errores frecuentes

  • Usar un correo inventado o con una errata: quedará registrado en los commits nuevos. Compruébalo con git config --get user.email.
  • Configurar --global en un equipo compartido: afecta a todos los repositorios de esa cuenta de usuario. En un aula con cuentas compartidas, usa configuración local.
  • Esperar que cambiar la configuración modifique commits previos: no ocurre; la identidad configurada se aplica a commits futuros.
  • Confundir Git con GitHub: esta configuración es de Git local. No crea cuenta, repositorio ni conexión con GitHub, GitLab u otra plataforma.

Ejercicio autocorregible

  1. Configura tu nombre, correo y main como rama inicial global.
  2. Muestra los tres valores con git config --global --get.
  3. Ejecuta git config --list --show-origin e identifica el archivo que contiene la configuración.
  4. En el siguiente repositorio que crees, configura temporalmente un correo local y verifica que prevalece sobre el global.

Criterios de revisión:

  • Los tres valores globales existen y son correctos.
  • Se distingue qué valor es global y cuál local.
  • Se explica que la configuración local tiene prioridad y no cambia la global.

Resumen

Al terminar, el alumnado debe saber configurar y verificar su identidad en Git, establecer una rama inicial por defecto y decidir cuándo una configuración debe ser global o exclusiva de un repositorio.

Estado editorial: listo.

Registro de revisión técnica

Revisado el 4 de agosto de 2026. En una configuración global aislada se han comprobado user.name, user.email e init.defaultBranch=main. Un repositorio nuevo toma main como rama inicial; un user.email local prevalece sobre el global y git config --unset user.email recupera el valor global. La salida de git config --list --show-origin identifica correctamente el archivo de cada ámbito.