git config

Configuration et création de projets

Lire et modifier les réglages de Git

La commande 'git config' lit et écrit des réglages stockés sous forme de paires clé = valeur. Sans portée, elle agit sur le dépôt actuel (.git/config) ; --global agit sur votre fichier utilisateur (~/.gitconfig) et s’applique à tous les dépôts de votre ordinateur. Un réglage du dépôt l’emporte sur le réglage global. Les premiers réglages dont tout le monde a besoin sont user.name et user.email, inscrits dans chaque commit.

Synopsis

git config [--global | --local] <key> [<value>]
git config [--global] --unset <key>
git config [--global] --list
[ ] facultatif| ou<arg> valeur à remplacer... répétable--flag option

Options

Cliquez sur une option pour la déplier

Débutant (3)

Lire ou écrire vos réglages utilisateur (~/.gitconfig), partagés par tous les dépôts.

RecommandéRéglez votre identité et vos préférences une fois pour tous vos projets

Exemple

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

Supprimer un réglage.

Si nécessaireSupprimer un réglage pour revenir à la valeur par défaut

Exemple

git config --unset pull.rebase

Lister chaque réglage en vigueur, avec sa valeur.

Si nécessaireComprendre quels réglages s’appliquent et d’où ils viennent

Exemple

git config --list --show-origin

Choisir la bonne option

Où vivent les réglages

Le plus spécifique l’emporte

CommandeFichierS’applique à
--system/etc/gitconfigTous les utilisateurs de l’ordinateur
--global~/.gitconfigTous vos dépôts
--local (default).git/configCe dépôt seulement

Exemples

Définir votre nom

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

Utilisé dans chaque commit.

Définir votre e-mail

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

Également utilisé dans chaque commit.

Lire un réglage

git config user.name

Affiche la valeur en vigueur ici.

Nom de la branche par défaut

git config --global init.defaultBranch main

git init démarrera sur main.

Exemples de workflows

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

Votre nom

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

Votre e-mail

3
git config --global init.defaultBranch main

Les nouveaux dépôts démarrent sur main

Dépannage

Author identity unknown

Cause : user.name / user.email ne sont pas définis

Définissez-les avec git config --global

Un réglage semble ignoré

Cause : Une autre portée le surcharge

git config --list --show-origin montre d’où vient chaque valeur

Astuces et pièges

Bonnes pratiques

  • ✓Définissez votre identité en global, et ne la surchargez par dépôt qu’en cas de besoin (p. ex. un e-mail professionnel).
  • ✓Vérifiez les réglages avec --show-origin quand quelque chose se comporte bizarrement.

Erreurs fréquentes

  • ✗Committer avant d’avoir défini user.name et user.email.
  • ✗Définir un e-mail professionnel avec --global sur un ordinateur personnel, ou l’inverse.
  • ✗Problèmes de guillemets : les noms avec des espaces doivent être entre guillemets.

FAQ

A:

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

A:

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