“No git repository found”说明Atom未识别当前项目为Git仓库，导致tree-view-git-status等依赖Git状态的插件静默失效；根本原因是项目根目录无.git文件夹、git.path未配置或Atom未从仓库根目录启动。
Git: Toggle Git Tab 报“No git repository found”说明什么
这代表 Atom 根本没识别到当前项目是 Git 仓库，所有依赖 Git 状态的插件（tree-view-git-status、minimap-git-diff、split-diff）都会静默失效——不是图标不显示，而是压根没启动监听逻辑。
常见诱因有三个：
- 项目根目录下没有
.git文件夹（注意：必须是项目最外层目录，子目录里的无效） -
Atom Settings → Core → git.path为空，且系统PATH中找不到git命令（Mac/Linux 检查which git，Windows 检查where git） - Atom 是从非仓库根目录启动的（比如在桌面打开 Atom，再用
File → Add Project Folder加了个子文件夹），此时git rev-parse --show-toplevel返回路径和 Atom 当前 project path 不一致
tree-view-git-status 图标颜色到底对应什么状态
它不显示文字提示，颜色语义和主流 IDE 不同，且不随主题变色，容易误判：
-
红色圆点：文件在工作区被修改（
git status显示modified:），但还没git add -
橙色圆点：已暂存（
git add过），等待git commit -
蓝色圆点：新文件（
untracked），且未被.gitignore排除 - 无图标 ≠ 已提交：可能是被
.gitignore忽略，也可能是权限变更、符号链接等 Git 不追踪的状态
想确认某文件真实 Git 状态，右键 tree-view 中该文件 → Git: Show File Status，会弹出终端输出原始 git status --short 结果。
minimap-git-diff 为什么右侧缩略图一片灰
它只渲染两类变更：git diff --cached（暂存区）和 git diff（工作区未暂存），其他一概不标。所以“改了代码却没反应”大概率是以下情况之一：
- 文件根本没被 Git 跟踪（
git status里都看不到） - 当前文件路径不在 Git 仓库根目录下（
git rev-parse --show-toplevel输出路径 ≠ Atom 的 project path） - 文件类型被识别为
Plain Text（右下角显示），minimap-git-diff默认跳过无语言模式的文件；需手动切换语法（如Ctrl+Shift+P→Change Language Mode） - 文件是软链接或权限变更（Git 不记录这些，diff 无输出）
split-diff 对比“当前 vs HEAD”失败的隐藏条件
这个功能看似一键触发，实则对环境极其敏感：
- 必须从 Git 仓库根目录启动 Atom，或通过
File → Add Project Folder加载根目录（不能只加子目录） - 只能在一个文件被打开时执行
split-diff:toggle；如果左右窗格各有一个文件，它会拒绝加载 HEAD 版本 - 当前文件必须已保存（不能是
untitled），且路径是真实磁盘路径（不能是相对路径别名） - 右窗格自动拉取的是
HEAD版本，不是暂存区；要对比暂存区，得先git add，再触发命令
最容易被忽略的是项目路径一致性——哪怕你 cd 到仓库根目录再执行 atom .，如果中间用过 Add Project Folder 加过其他路径，Atom 可能仍以旧路径为 project root，导致 .git 找不到。
