Solución:
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 un opción, p.ej
rm -f # does nothing
rm -- -f # deletes a file named "-f"
git checkout1 también toma -- lo que significa que los argumentos subsiguientes no son su parámetro opcional “en árbol” que especifica qué confirmación desea.
Entonces en este contexto es a salvo usar -- siempre, pero tu necesitar cuando el archivo que desea revertir tiene un nombre que comienza con -, o es el mismo que el nombre de una sucursal. 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 haces si tienes un rama cuyo nombre comienza con -. Quizás no hagas eso en primer lugar.
1 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.
Cualquier cosa que siga a la -- 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.