如何排查并解决git报错fatal not a git repository的问题？

本文共计656个文字，预计阅读时间需要3分钟。

避免盲目感觉判断，pwd 输出的路径才是实际依赖的。很多人在 src 或 backend 目录下执行 git status，但实际上 .git 只在上一级。使用 git rev-parse --show-toplevel 最直接：

.git 目录是否存在或损坏？

.git 是隐藏目录，ls 默认看不见，必须加 -a；Windows 资源管理器需手动开启“显示隐藏的项目”。但存在不等于可用：

• cat .git/config 看是否可读、格式正常（比如有没有空文件或乱码）
• cat .git/HEAD 必须是类似 ref: refs/heads/main 或一个 40 位哈希，空文件或非法内容会导致同样报错
• 如果 .git 被重命名为 .git-disabled（某些 IDE 或脚本会干这事），直接改回来就行，不用 git init

git init 能不能当“修复”用？

git init 不是修复命令，它是新建命令 —— 它创建一个空的 .git，不恢复历史、不关联远程、不保留分支。你原本是从 https://xxx.git 克隆的，现在 git init 后得立刻补：git remote add origin https://xxx.git。