Diferencia entre "git checkout <nombre de archivo>" y "git checkout - - <nombre de archivo>"

http://norbauer.com/notebooks/code/notes/git-revert-reset-a-single-file

He encontrado una publicación.

Pero todavía no sé cuál es la diferencia entre

1. git checkout <filename>

2. git checkout -- <filename>

¿En qué situación debería usar el primero y el segundo respectivamente?

La "opción" especial --significa "tratar cada argumento después de este punto como un nombre de archivo, sin importar cómo se vea". Esto no es específico de Git, es una convención general de línea de comandos de Unix. Normalmente lo usa para aclarar que un argumento es un nombre de archivo en lugar de una opción , por ejemplo

rm -f      # does nothing
rm -- -f   # deletes a file named "-f"

git checkout¹ también --significa que los argumentos subsiguientes no son su parámetro opcional "en árbol" que especifica qué confirmación desea.

Entonces, en este contexto, es seguro usarlo --siempre, pero lo necesita cuando el archivo que desea revertir tiene un nombre que comienza con -, o es el mismo que el nombre de una rama. Algunos ejemplos de desambiguación de rama / archivo:

git checkout README     # would normally discard uncommitted changes
                        # to the _file_ "README"

git checkout master     # would normally switch the working copy to
                        # the _branch_ "master"

git checkout -- master  # discard uncommitted changes to the _file_ "master"

y desambiguación de opciones / archivos:

git checkout -p -- README  # interactively discard uncommitted changes
                           # to the file "README"

git checkout -- -p README  # unconditionally discard all uncommitted
                           # changes to the files "-p" and "README"

No estoy seguro de lo que debe hacer si tiene una sucursal cuyo nombre comienza con -. Quizás no hagas eso en primer lugar.

¹ en este modo; "Checkout" también puede hacer varias otras cosas. Nunca he entendido por qué git eligió implementar "descartar cambios no confirmados" como un modo del subcomando "checkout", en lugar de "revertir" como la mayoría de los otros VCS, o "restablecer", que creo que podría tener más sentido en los propios términos de git.

Todo lo que siga a --se trata como un nombre de archivo (no como un argumento de programa). Esto es importante si, por ejemplo, tiene nombres de archivo que comienzan con guiones.