Volver al blog

Trae un archivo de otra rama sin hacer merge: git restore --source

Serie: Git sin miedo

Estás en tu rama y necesitas un solo archivo tal como está en otra rama. No quieres hacer merge (te traería todo lo demás) ni cherry-pick (te traería commits enteros). Para eso existe git restore --source.

El comando

git restore --source=otra-rama -- ruta/al/archivo.ts
  • --source acepta cualquier referencia: una rama, un tag o un hash de commit.
  • El -- separa las opciones de las rutas. Puedes pasar varios archivos o una carpeta entera.
  • Por defecto solo cambia tu directorio de trabajo: el archivo aparece modificado, sin preparar para commit.

Si además quieres dejarlo preparado (en el staging):

git restore --source=otra-rama --staged --worktree -- ruta/al/archivo.ts

Después revisa el cambio y haz un commit normal:

git diff --staged
git commit -m "Trae la configuración de otra-rama"

Cuándo usarlo

  • Recuperar la versión de un archivo de otra rama o de un commit antiguo.
  • Probar la configuración de un compañero sin mezclar su trabajo.
  • Deshacer cambios locales en un archivo concreto (git restore archivo sin --source vuelve a la versión de HEAD).

Cuándo no usarlo

  • Si necesitas el historial: restore copia el contenido, no los commits. Si quieres conservar quién hizo qué y cuándo, usa merge o cherry-pick.
  • Si el archivo depende de otros cambios de esa rama: traerlo solo puede dejar tu rama a medias. Revisa qué más tocó ese trabajo antes.
  • Con cambios locales sin guardar en ese archivo: restore los sobrescribe sin preguntar. Si dudas, haz git stash antes.

git restore existe desde Git 2.23. En versiones antiguas el equivalente es git checkout otra-rama -- ruta/al/archivo.ts.