Xavier Lamorlette

git

Commandes

add

Ajoute un fichier dans l'index (pour le prochain commit).

git add . : ajoute tous les fichiers du répertoire courant
-p : choisit interactivement, pour chaque fichier, les bouts à ajouter à l'index

blame

Pour un fichier, ligne pas ligne, montre la révision et l'auteur.

git blame [fichier]

branch

Liste les branches.

git branch -v : montre les derniers commits
git branch -vv : montre aussi les branches distantes de référence
git branch -r : liste les branches distantes
git branch -a : liste les branches locales et distantes
git branch [branche] : crée une branche
git branch -d [branche] : efface une branche (interdit si elle n'a pas été fusionnée)
- git branch -D [branche] : efface une branche même si elle n'a pas été fusionnée
git branch [x] [y] : crée une branche x à partir de la révision y
git branch -m [branche] : renomme la branche courante
git branch -u [branche] : suit une branche distante

checkout

git checkout [fichier] = git restore [fichier] : annule les changements sur le fichier (revient au dernier commit)
git checkout [branche] = git switch [branche] : bascule sur une branche
git checkout -b [branche] = git switch -c [branche] = git branch [branche] && git checkout [branche]
git checkout -b [x] [y] = git switch -c [x] [y] = git branch [x] [y] && git checkout [x]

cherry-pick

git cherry-pick [sha] : applique un commit sur la branche courante.
Cf SO : How to move certain commits to another branch in git?.

commit

Enregistre les changements.

-a : enregistre tous les fichiers modifiés et effacés (mais pas les nouveaux)
-m "[message]" : message de description
--amend : amende le dernier commit (permet aussi de changer son message)
--fixup [sha] : indique que le commit en corrige un précédent
--no-verify : désactive les hooks

diff

Montre les changements.

-b : ignore les changements de nombre d'espaces
-w : ignore tous les changements sur les espaces
--staged : montre les changements déjà dans l'index
git diff [sha]^ [sha] : changements entre un commit et le précédent

fetch

Récupère les commits du dépôt de référence.

--prune : efface localement les branches supprimées sur le dépôt

init

Initialise un dépôt local (crée le répertoire .git).

log

Affiche l'historique.

--summary : montre seulement les fichiers modifiés
--oneline : une ligne par commit
--decorate : montre les changements de branches intermédiaires
--graph : visualisation graphique
git log -- file : liste les commits qui ont modifié le fichier donné
git log origin/prod.. : équivalent de hg out
git log ..origin/prod : à faire après un git fetch, équivalent de hg in

merge

Fusionne les changements venant de la branche donnée en paramètre.

exemple: git merge origin/prod
--no-ff : “no fast forward” : crée un commit pour ne pas perdre l'information sur l'existence de la branche

pull

Récupère les changements du dépôt de référence = git fetch && git merge.

push

Pousse les changements vers le dépôt de référence.

git push [dépôt distant] [branche locale]:[branche distante]
- -u : se souvient des paramètres (notamment le dépôt et la branche) pour le prochain push
git push --set-upstream origin [branche locale] : crée la branche distante si nécessaire, et la garde comme référence distante
git push origin --delete [branche distante] : efface une branche distante

rebase

git rebase [branche] : recopie (et donc change leurs sha1) les commits de la branche courante par dessus ceux de la branche donnée en paramètre.

reflog

Affiche l'historique des actions.

remote

Gère le dépôt de référence.

git remote -v : montre quel est le dépôt de référence
git remote add origin [url du dépôt] : ajoute un dépôt de référence
git remote set-url origin [url du dépôt] : change le dépôt de référence

reset

Réinitialise.

git reset [fichier] : enlève un fichier de la liste du prochain commit
git reset [sha] : déplace le head et nettoie l'index
git reset HEAD^ : annule le dernier commit et nettoie l'index
git reset --soft [sha] : déplace le head, mais sans mettre à jour les fichiers et l'index
git reset --soft HEAD^ : annule le dernier commit, mais laisse l'index intact
git reset --hard : nettoie le répertoire de travail, utile après que des changements ont étés poussés depuis un autre dépôt
git reset --hard [sha] : déplace le head, nettoie l'index, et nettoie le répertoire de travail
git reset --hard HEAD^ : annule le dernier commit, nettoie l'index et abandonne les modifications des fichiers

restore

Annule les changements sur un fichier = git checkout [fichier].

revert

Crée les changements qui annulent un commit donné.

rm

Supprime et oublie un fichier.

git rm [fichier]
-r : récursif (pour un répertoire)

show

git show [sha] : montre les détails d'un commit

stash

Met de côté les changements locaux.

git stash : met de côté les changements en cours (y compris ceux dans stage)
git stash push [-m message] files : met de côté les changements sur certains fichiers
git stash list : liste les changements mis de côté
git stash show stash@{[x]} : montre le résumé du changement (comme git diff --stat)
git stash show -p stash@{[x]} : montre le diff du changement
git stash apply stash@{[x]} : ré-applique le changement
git stash drop stash@{[x]} : supprime le changement
git stash pop stash@{[x]} : applique et supprime le changement
git stash clear : supprime tous les changements

Pour les commandes prenant un paramètre d'index, s'il est omis, le plus récent changement est utilisé.

status

Donne le statut de l'index.

staged : fichiers prêts à être commités
unstaged : fichiers modifiés mais pas dans l'index
untracked : fichiers encore jamais commités
deleted : fichiers effacés

switch

Change de branche.

git switch [branche] = git checkout [branche]
-c : crée la branche si nécessaire : git switch -c [branche] = git checkout -b [branche]
git switch -c [nouvelle-branche] [branche-existante] : part d'une branche existante (autre que la courante)

Cas particuliers d'utilisation

Fusionner les derniers commits en un seul

git reset --soft [commit précédent ceux à fusionner]
git commit -m "message"

ou :

git rebase -i --autosquash [commit précédent ceux à fusionner]

Déplacer les derniers commits vers une nouvelle branche

git branch [nouvelle branche]
git reset --hard [dernier commit à garder dans la branche actuelle]
git switch [nouvelle branche]

Corriger le message d'un ancien commit

git rebase -i [commit précédent celui à corriger]
# écrire edit devant le commit à corriger
git commit --amend  # pour pouvoir corriger le message
git rebase --continue

Fusionner plusieurs anciens commits en un seul

git rebase -i [dernier commit à conserver]
# premier écran : basculer de “pick” à “squash” pour les commits à fusionner
# deuxième écran : message de commit

Annuler tous les changements locaux

Utile notamment après avoir reçu un git push.

> git checkout -f

Authentification permanente sur le dépôt

Atlassian: Permanently authenticating with Git repositories.

Garder l'authentification en cache une heure:

> git config --global credential.helper 'cache --timeout 3600'

Récupérer localement le head d'un collègue

> git remote add -f [bernard] https://[moi]@[serveur]/[projet].git

(> git remote update)

> git diff master remotes/[bernard]/master

> git fetch [bernard] master:[bernard]
> git checkout [bernard]

> git checkout master

> git remote rm [bernard]
> git branch -D [bernard]

Nettoyer les tags

Effacer les tags locaux absents sur le dépôt de référence

git tag -l | xargs git tag -d && git fetch -t

Effacer un tag sur le dépôt de référence

git push --delete origin […]

Erreurs

`could not delete references: cannot lock ref [x]: Unable to create [x.lock]: File exists`

Cette erreur peut notamment arriver lors d'un git pull --prune.

- Vérifier qu'aucun autre processus git n'existe.
- Effacer le fichier .lock.
- Effacer explicitement la référence distante : git update-ref -d [x].

Configuration

~/.gitconfig :

[user]
        email = …
        name = …
[core]
        autocrlf = input
        safecrlf = false
[pull]
        rebase = false
[alias]
        lg = "log --all --decorate --oneline --graph"

Références

La dernière mise à jour de cette page date de décembre 2025.

Le contenu de ce site est, en tant qu'œuvre originale de l'esprit, protégé par le droit d'auteur.
Pour tout commentaire, vous pouvez m'écrire à xavier.lamorlette@gmail.com.