Diferencia entre "git checkout <filename>" y "git checkout - - <filename>"

Question

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

He encontrado un puesto.

Pero aún no se sabe cuál es la diferencia entre

1. git checkout <filename>

2. git checkout -- <filename>

En qué situación debería utilizar primero y segundo, respectivamente?

Answer 1

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 , p.

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

git checkout lleva también -- en el sentido de que los argumentos posteriores no son su opcional que especifica el parámetro "treeish", que desea comprometerse.

Así pues, en este contexto, es segura utilizar -- siempre, pero necesidad que 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 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 opción/archivo:

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 tiene una rama cuyo nombre comienza con -. Quizás no hagas eso en primer lugar.

---

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

Answer 2

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