"git checkout --" . vs git checkout

Question

J'ai toujours utilisé git checkout -- . pour vider mon répertoire de travail. Je crois avoir lu quelque part que le -- était nécessaire pour éviter que git ne pense que vous passez des paramètres (ou quelque chose comme ça).

Maintenant, un collègue m'a dit que je pouvais laisser tomber le -- et, en effet, un test rapide a donné exactement le même résultat.

Y a-t-il une différence entre ces deux commandes ?

PS : Je pose la question ici parce que git checkout -- . vs git checkout . est un peu difficile à googler...

Answer 1

Je crois me souvenir que le -- est un moyen d'indiquer à Git de traiter ce qui suit checkout comme un fichier et non comme une branche. Supposons que vous ayez à la fois un fichier et une branche appelés stuff . La commande suivante semble alors ambiguë :

git checkout stuff

parce qu'il n'est pas clair si vous demandez le checkout d'un fichier ou d'une branche. En utilisant -- vous demandez explicitement à Git d'extraire un fichier de ce nom/chemin. Ainsi, dans ce cas, les commandes suivantes permettent d'extraire une branche et un fichier appelé stuff :

git checkout stuff       # checkout the branch stuff
git checkout -- stuff    # checkout the file stuff

Notez que git checkout <name> est vraiment destiné aux branches, mais la syntaxe de Git est plus souple, et si Git ne peut pas trouver une branche, il cherchera un fichier.

Étroitement lié : Git change de branche quand un fichier de même nom est présent

Answer 2

-- comme argument autonome (c'est-à-dire ne faisant pas partie d'un autre argument) est utilisé par de nombreux programmes de ligne de commande UNIX pour indiquer que tout ce qui le suit n'est pas un argument.

Pourquoi ? Eh bien, dans ce cas, il est utilisé dans le cas où vous avez un chemin dont le nom commence par -- ce qui ne doit pas être interprété comme un argument en soi.

c'est-à-dire git checkout -- --mydirectory qui, sans le -- entraînerait une erreur.