Qué es un git worktree: cómo funciona por dentro y cuándo usarlo

Un git worktree es un directorio adicional dentro del mismo repositorio, que cuenta con su propia rama activa, HEAD y índice. A diferencia de la carpeta original, el worktree guarda su propio historial, ramas y configuración. Con este recurso, puedes trabajar simultáneamente en diferentes ramaes, como main y feature/login, sin necesidad de clonar el repositorio o usar git stash.

Este comando fue introducido en git 2.5 (2015), aunque no siempre es evidente su utilización, ya que solo tiene sentido al comprender la estructura interna de un repositorio.

En un repositorio git, existen tres piezas principales: la base de objetos (historial), las referencias (ramas y tags) y el estado de trabajo (rama activa, índice y archivos). Cada one de estos componentes contiene información específica, como el historial de commits, los nombres que apuntan a esos commits (ramas, tags y remotas) y la rama activa, los cambios preparados para el próximo commit y los archivos visibles en la carpeta.

Un trabajo único del repositorio solo puede mantener una rama activa a la vez. Sin embargo, un git worktree multiplica solo la tercera pieza: el estado de trabajo. Cada worktree tiene su propio HEAD, índice y carpeta de archivos, pero comparte la base de objetos y referencias con el worktree principal. Los worktrees se denominan según su origen: la carpeta donde clonaste o iniciaste el repositorio es el worktree principal, mientras que los creados con git worktree add son worktrees vinculados.

Aunque un worktree vinculado comparte todos los aspectos funcionales con el principal, hay limitaciones a considerar. Una rama solo puede estar activa en un worktree en un momento dado y no reproduce archivos o configuraciones que git no versiona, como node_modules, .env o builds.