git config

Configuración y creación de proyectos

Lee y cambia los ajustes de Git

El comando 'git config' lee y escribe ajustes guardados como pares clave = valor. Sin ámbito, trabaja sobre el repositorio actual (.git/config); --global trabaja sobre tu archivo de usuario (~/.gitconfig) y se aplica a todos los repositorios de tu ordenador. Un ajuste del repositorio prevalece sobre el global. Los primeros ajustes que todos necesitan son user.name y user.email, que se graban en cada commit.

Sinopsis

git config [--global | --local] <key> [<value>]
git config [--global] --unset <key>
git config [--global] --list
[ ] opcional| o<arg> valor a sustituir... repetible--flag opción

Opciones

Haz clic en una opción para desplegarla

Principiante (3)

Lee o escribe tus ajustes de usuario (~/.gitconfig), compartidos por todos los repositorios.

RecomendadoDefine tu identidad y preferencias una vez para todos los proyectos

Ejemplo

git config --global user.name "Ada Lovelace"

Elimina un ajuste.

Cuando haga faltaEliminar un ajuste para volver al valor por defecto

Ejemplo

git config --unset pull.rebase

Lista cada ajuste vigente con su valor.

Cuando haga faltaDepurar qué ajustes se aplican y de dónde vienen

Ejemplo

git config --list --show-origin

Elegir la opción adecuada

Dónde viven los ajustes

Gana el más específico

ComandoArchivoSe aplica a
--system/etc/gitconfigTodos los usuarios del ordenador
--global~/.gitconfigTodos tus repositorios
--local (default).git/configSolo este repositorio

Ejemplos

Definir tu nombre

git config --global user.name "Ada Lovelace"

Se usa en cada commit.

Definir tu correo

git config --global user.email ada@example.com

También se usa en cada commit.

Leer un ajuste

git config user.name

Muestra el valor vigente aquí.

Nombre de la rama por defecto

git config --global init.defaultBranch main

git init empezará en main.

Ejemplos de flujos de trabajo

1
git config --global user.name "Ada Lovelace"

Tu nombre

2
git config --global user.email ada@example.com

Tu correo electrónico

3
git config --global init.defaultBranch main

Los repositorios nuevos empiezan en main

Solución de problemas

Author identity unknown

Causa: user.name / user.email no están definidos

Defínelos con git config --global

Un ajuste parece ignorado

Causa: Otro ámbito lo sobrescribe

git config --list --show-origin muestra de dónde viene cada valor

Consejos y trampas

Buenas prácticas

  • ✓Define tu identidad globalmente y sobrescríbela por repositorio solo cuando haga falta (p. ej. un correo de trabajo).
  • ✓Revisa los ajustes con --show-origin cuando algo se comporte de forma rara.

Errores comunes

  • ✗Hacer commit antes de definir user.name y user.email.
  • ✗Definir un correo de trabajo con --global en un ordenador personal, o al revés.
  • ✗Problemas de comillas: los nombres con espacios necesitan comillas.

Preguntas frecuentes

A:

~/.gitconfig (en Windows: C:\Users\<you>\.gitconfig).

A:

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