Instalar Git es solo el primer paso. Para empezar a trabajar con repositorios de forma cómoda y evitar errores desde el inicio, conviene dejarlo bien configurado con git config. Esta utilidad define parámetros básicos como tu nombre, tu correo, el editor por defecto y otras opciones que Git usará cada vez que crees commits o trabajes desde la terminal.
Si todavía no tienes Git instalado, puedes revisar primero nuestra guía sobre cómo instalar Git en Windows, Linux y macOS. Y si quieres entender mejor el contexto antes de tocar la configuración, también puede ayudarte leer qué es Git, para qué sirve y por qué deberías aprenderlo.
Qué hace git config y por qué importa
git config es el comando que permite ajustar el comportamiento de Git mediante distintos niveles de configuración. En la práctica, te ayuda a personalizar la herramienta para que se adapte a tu entorno y a tu identidad como desarrollador.
Sin esta configuración inicial, Git no sabrá quién está haciendo los commits. Eso no impide que la herramienta funcione, pero sí deja tus cambios sin una firma clara, algo poco útil en proyectos reales y equipos colaborativos.
Niveles de configuración en Git
Git puede guardar ajustes en tres ámbitos principales: local, global y de sistema. No hace falta complicarse al principio, pero sí conviene entender la diferencia para saber dónde estás aplicando cada cambio.
Global suele ser la opción más habitual al empezar, porque afecta a todos los repositorios del usuario actual. Local solo impacta en un proyecto concreto. Sistema se usa menos, ya que aplica a toda la máquina.
# Configuración global: se aplica a todos tus repositorios
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
# Configuración local: solo para el repositorio en el que estás
git config user.name "Nombre del proyecto"
Configurar tu identidad en Git
El primer ajuste que deberías hacer es definir tu nombre y tu correo electrónico. Estos datos quedarán asociados a los commits que realices y permiten identificar correctamente la autoría de los cambios.
Usa el nombre con el que quieres aparecer en el historial del proyecto. En el correo, conviene emplear una dirección que controles y que uses de forma consistente, sobre todo si vas a colaborar en repositorios remotos como GitHub, GitLab o Bitbucket.
git config --global user.name "Ana Pérez"
git config --global user.email "ana.perez@ejemplo.com"Una vez hecho esto, puedes comprobar que la configuración quedó guardada con este comando:
git config --global --listTambién puedes consultar un valor concreto, por ejemplo:
git config --global user.nameElegir el editor por defecto
En varias situaciones Git abrirá un editor de texto, por ejemplo al escribir mensajes de commit más largos o al redactar mensajes de merge. Si no defines uno, Git usará el que tenga configurado por defecto en tu sistema, lo que puede resultar incómodo si prefieres trabajar con otro.
Configurar el editor es especialmente útil si vienes de usar entornos distintos, como VS Code, Vim o Nano. No hay una única opción correcta: elige la que te resulte más natural para editar texto desde terminal.
# Ejemplo con Visual Studio Code
git config --global core.editor "code --wait"
# Ejemplo con Vim
git config --global core.editor "vim"
# Ejemplo con Nano
git config --global core.editor "nano"Este ajuste mejora mucho la experiencia diaria, porque evita interrupciones innecesarias cuando Git necesita que escribas un mensaje o resuelvas una situación puntual.
Revisar la configuración activa
Antes de seguir trabajando, merece la pena comprobar qué valores están activos. Así confirmas que no hay errores de escritura en el nombre, el correo o el editor, algo bastante habitual cuando se ejecuta la configuración por primera vez.
# Ver toda la configuración global
git config --global --list
# Ver toda la configuración disponible según el contexto
git config --list
# Ver un dato específico
git config user.emailSi observas un valor incorrecto, basta con volver a ejecutar git config con el dato correcto. Git sobrescribirá la opción anterior sin pedir confirmación extra.
Ajustes útiles para empezar con buen pie
Además de la identidad y el editor, hay otras opciones que suelen ser muy prácticas en la configuración inicial. No son obligatorias, pero sí mejoran la experiencia en el día a día.
autocrlf y saltos de línea
En equipos que trabajan entre Windows, Linux y macOS, el manejo de saltos de línea puede generar diferencias innecesarias en el historial. La opción core.autocrlf ayuda a controlar cómo Git transforma los finales de línea entre el entorno local y el repositorio.
Este ajuste depende del sistema operativo y del flujo de trabajo del equipo, así que conviene aplicarlo con criterio. Si no estás seguro, revisa la política del proyecto antes de cambiarlo.
# Ejemplo habitual en Windows
git config --global core.autocrlf true
# En otros entornos puede variar según la estrategia del equipo
git config --global core.autocrlf inputColores en la terminal
Git puede colorear su salida para hacer más legible la información. Es una mejora sencilla, pero muy útil cuando revisas estados, diferencias o mensajes de error desde consola.
git config --global color.ui autoAlias para comandos frecuentes
Si usas Git a diario, los alias ahorran tiempo y reducen escritura repetitiva. Puedes crear accesos cortos a comandos frecuentes como ver el estado, el historial o las diferencias entre archivos.
# Alias útil para "git status"
git config --global alias.st status
# Alias para ver el historial en una línea por commit
git config --global alias.lg "log --oneline --graph --decorate --all"Con esto podrás escribir git st o git lg en lugar de comandos más largos. No hace falta crear muchos alias al principio; empieza por los que realmente vayas a usar.
Dónde guarda Git esta configuración
Git almacena estos valores en archivos de configuración, normalmente en tu directorio de usuario cuando usas la opción global. Aunque no necesitas editarlos manualmente para comenzar, resulta útil saber que esta configuración persiste entre sesiones.
En la práctica, git config actúa como una capa segura y cómoda para escribir esos ajustes sin abrir archivos de sistema ni tocar opciones complejas a mano.
Errores comunes al configurar Git por primera vez
Uno de los fallos más habituales es escribir mal el correo o usar una identidad distinta según el equipo. Eso puede generar commits firmados con datos inconsistentes y darte problemas al identificar cambios en servicios remotos.
Otro error frecuente es mezclar configuraciones globales y locales sin saber cuál tiene prioridad. Si un repositorio concreto parece ignorar tu nombre o tu editor, revisa si hay una configuración local que esté sobrescribiendo la global.
También es común olvidar comillas cuando el valor contiene espacios, por ejemplo en nombres compuestos o rutas del editor. Mantener una sintaxis limpia evita sorpresas y hace la configuración más predecible.
Resumen práctico para empezar
Si vas a configurar Git por primera vez, céntrate en lo esencial: nombre, correo y editor. Después, añade solo los ajustes que encajen con tu sistema y tu forma de trabajar.
Con unos pocos comandos de git config dejarás la herramienta lista para crear commits identificables, trabajar con más comodidad y reducir fricciones desde tu primer proyecto.
# Configuración inicial recomendada
git config --global user.name "Tu Nombre"
git config --global user.email "tu@email.com"
git config --global core.editor "code --wait"
git config --global color.ui auto
# Verificar la configuración
git config --global --listFuentes y lecturas recomendadas
Documentación oficial de git config
Pro Git: personalizar Git y su configuración
Documentación oficial de GitHub para trabajar con Git
Deja una respuesta