根本原因是tree-view-git-status依赖atom内置git服务，若项目根目录无有效.git或git.path未配置，插件静默失效；验证方式为执行git: toggle git tab，报“no git repository found”即确认底层集成中断。
tree-view-git-status 为什么文件状态不显示？
根本原因不是插件没装，而是它完全依赖 Atom 内置的 git 服务——如果当前项目根目录下没有有效的 .git 目录，或 Atom 没读到 git.path 配置（比如 Git 命令不在系统 PATH），插件就静默失效，tree-view 里连一个图标都不会加。
验证方法：打开命令面板（Ctrl+Shift+P），输入 Git: Toggle Git Tab，如果报错 “No git repository found” 或空白，说明底层 Git 集成已断，tree-view-git-status 必然不工作。
- 确保项目根目录存在
.git（不是子目录） - 检查 Atom 设置 → Core →
git.path是否为空；若为空，填入git命令绝对路径（如/usr/bin/git或C:\Program Files\Git\bin\git.exe） - 重启 Atom —— 插件不会热加载 Git 状态
图标颜色和状态对应关系怎么查？
tree-view-git-status 的图标语义直接映射 Git 工作区状态，但不显示文字提示，容易误读。它的颜色逻辑和 VS Code / IDEA 不同，且不随主题自动适配：
-
红色圆点：文件已修改（
git status显示modified:），但未暂存 -
橙色圆点：文件已暂存（
git add过），等待提交 -
蓝色圆点：新文件（
untracked），未被.gitignore排除 - 无图标 ≠ 已提交：也可能是被
.gitignore忽略，或文件权限变更等 Git 不追踪的状态
想确认某文件真实状态，右键 tree-view 中该文件 → Git: Show File Status，会弹出终端输出原始 git status --short 结果。
高亮图标被其他插件盖住了怎么办？
常见冲突来自 file-icons 和 tree-view-finder：前者在文件名前插入彩色语言图标，后者可能重绘整个 tree-view 节点 DOM。它们的 SVG 图标层级高于 tree-view-git-status 的纯 CSS 圆点，导致 Git 状态图标不可见。
- 临时禁用
file-icons测试是否恢复显示 - 若必须共存，在
styles.less中强制提升 z-index：.tree-view .file .name::before { z-index: 10 !important; } -
tree-view-finder的搜索高亮会覆盖所有图标，搜索时图标消失属正常行为，无需修复
为什么刚 git commit 后图标没立刻变？
插件默认每 5 秒轮询一次 git status，不是实时监听 fs 事件。这意味着你执行命令行 git commit 后，tree-view 中的图标最多延迟 5 秒才更新，期间仍显示旧状态。
手动刷新方式只有两个有效：
- 按
Ctrl+Shift+P→ 输入Tree View Git Status: Refresh（需插件 v2.0+） - 切换到其他 tab 再切回来（触发 tree-view 重绘）
注意：不要依赖保存文件触发刷新——tree-view-git-status 和编辑器保存动作完全解耦，改完代码 Ctrl+S 对图标无任何影响。
