fatal: not a git repository — cinco causas, un comando

■ space · la sonda del recorrido · fig 1

Git sube por el árbol buscando .git, se detiene en la primera — cinco cosas rompen esa búsqueda, un comando las separa.

■ la respuesta primero

Ejecuta git rev-parse --show-toplevel || ls -a — un comando separa las causas antes de que toques nada.

La raíz impresa → estás fuera del repo; cd nada ahí. Sin .git en ls -a → nunca hubo repo: re-clona, no git init.

Error en cada repo de la máquina → un GIT_DIR ; unset GIT_DIR.

5causas detrás de una sola línea fatal

1comando las separa

20minutos que cuesta la jugada del directorio-de-arriba

01EL RECORRIDO

git busca una entrada, hacia arriba, y se detiene en la primera — la máquina repite la búsqueda

FIG 1 · LA SONDA DEL RECORRIDOteclas 1–6 — o los botones

la sonda

$ git rev-parse --show-toplevel
/home/you/projects/myapp

ENCONTRADO — EL RECORRIDO SE DETUVO EN .GITarreglo — nada que arreglar: el recorrido está sano

INICIO src/api/ · PISOS TOCADOS 2 · VEREDICTO ENCONTRADO

estás aquí → escribiste git pull aquí → el recorrido se detiene aquí, en el primer .git que encuentra

02LA TABLA DE CAUSAS

cinco cosas rompen la búsqueda — empareja tu síntoma con una fila

síntoma	causa probable	arreglo
error en un proyecto, `ls -a` no muestra ningún `.git`	descarga ZIP / archivos copiados	`git clone` todavía
error desde una subcarpeta, la raíz funciona	parado fuera del árbol	`cd "$(git rev-parse --show-toplevel)"`
error en cada directorio, incluso los que funcionaban	`GIT_DIR` exportado	`unset GIT_DIR`, purgalo del perfil de shell
error dentro de una carpeta de submodule	submodule sin inicializar	`git submodule update --init --recursive`
`.git` es un archivo, el error persiste	puntero worktree/submodule colgado	`git worktree repair`, si no re-clona

verificación: git rev-parse --show-toplevel → la ruta raíz del repo, sin error

03LOS DOS PRIMEROS MIENTEN

la tabla arregla síntomas; las dos primeras causas son donde miente la memoria muscular

la forma del subdirectorio—hiciste cd dentro de docs/ o src/api/ y el hábito del shell dice que la raíz está aquí — git sube, no encuentra nada, se detiene

la forma del clone—git clone siempre crea un subdirectorío con el nombre del repo — el checkout queda un nivel más abajo de donde estás parado

la forma del zip—Code → Download ZIP manda solo la instantánea de la fuente: sin .git, sin historial, sin remote

la forma copiada—archivos copiados sin la carpeta oculta — una herramienta de limpieza que borró .git como «basura oculta» acaba igual

salta a la raíz — funciona desde cualquier profundidad dentro del repo

git rev-parse --show-toplevel   # prints the root when one exists
cd "$(git rev-parse --show-toplevel)"   # jump there in one step

nunca hubo un repo — recupera el historial

ls -a   # no .git here
git clone <url>   # the fix — again, not git init

git init no repara un repo — crea uno vacío donde estás parado.

04LAS ÚLTIMAS TRES TE SIGUEN

las tres restantes son ambientales — el error se exporta, cuelga, o nunca nació

la seña: git funcionaba aquí hace una hora

env | grep GIT_DIR     # GIT_DIR=/some/old/path
unset GIT_DIR

GIT_DIR exportado—una ruta fija reemplaza el descubrimiento, así que cada directorio «normal» se vuelve «no es un repositorio» — si vuelve cada mañana, una línea en ~/.bashrc, ~/.zshrc, o un wrapper de CI lo exporta: purgalo allí

puntero muerto—.git en un archivo de una línea nombra un directorio en otra parte del disco; el objetivo se movió o se borró → el puntero cuelga y el error persiste aunque .git está justo ahí — git worktree repair reconecta lo que puede, cualquier otra cosa: re-clona

submodule—la carpeta existe en el árbol del repo padre pero nunca fue inicializada — no hay .git dentro todavía; git submodule update --init --recursive desde el padre la llena

los extraños sin seguimiento hacen dedo con los árboles copiados — una pasada limpia los resuelve una vez el clone está en su sitio

■ sello honesto Probado en: git 2.4x · bash + zsh · submodules y worktrees. Primera publicación 2026-09-28. La búsqueda hacia arriba, la anulación GIT_DIR y el archivo de puntero del worktree son el comportamiento de descubrimiento documentado de git; las cinco causas son el conjunto completo detrás de este error, tecleado desde repos que volvieron.

fin de las cinco causas · nada fetchado · todo local