git config
permite obtener y establecer variables de configuración que controlan el aspecto y funcionamiento de Git.
Estas variables pueden almacenarse en 3 lugares:
/etc/gitconfig
: archivo de configuración de todos los usuarios del sistema.- Usamos
git config --system
para leer o modificar este archivo:
git config --system -l ## ver los valores del archivo (-l: --list) git config --system -e ## editar el archivo (-e: --?)
- Usamos
~/.gitconfig
o~/.config/git/config
: archivo de configuración del usuario actual del sistema.- Usamos
git config --global
para leer o modificar este archivo:
git config --global -l ## ver los valores del archivo git config --global -e ## editar el archivo
- Usamos
.git/config
: archivo de configuración del repositorio actual.
Cada nivel sobrescribe los valores del nivel anterior, por lo que los valores de .git/config[3]
tienen preferencia sobre los de /etc/gitconfig[1]
.
Por ejemplo, en el archivo de configuración --system
está establecido el editor que selecionamos durante la instalación de Git y esta configuración afecta a todos los usuarios del sistema. Podríamos establecer otro editor en la configuración --global
para que afecte solo a nuestro usuario de sistema. En este caso estableceremos VSCode como editor:
git config --global core.editor code
$ git config --global user.name "Cristian Flores" $ git config --global user.email [email protected]
Sobrescribir información en proyectos específicos:
$ git config user.name "Andrés"
git config --global color.ui auto
git config --global merge.conflictstyle diff3
$ git config --global alias.l "log --oneline --decorate --all" $ git config --global alias.s "status -s -b"
Ver lista de todos los alias añadidos:
git config -- global -l
Modificar:
git config -- global -e
Mostrar todas las propiedades que Git ha configurado:
$ git config --list user.name=Cristian Flores [email protected] color.status=auto color.branch=auto color.interactive=auto color.diff=auto ...
Puede que veamos claves repetidas porque Git lee la misma clave de distintos archivos (por ejemplo, /etc/gitconfig
y ~/.gitconfig
). En estos casos, Git usa el último valor para cada clave única que ve.
Comprobar el valor que Git utilizará en una clave específica:
$ git config user.name Cristian Flores
git help
Obtener ayuda de un comando específico:
$ git help commit $ git commit --help $ man git-commit