根本原因是tree-view-git-status依赖Atom内置Git服务，若项目根目录无有效.git或git.path未配置，插件静默失效；验证方式为执行Git: Toggle Git Tab，报“No git repository found”即确认底层集成中断。
Git 服务未启用导致 tree-view-git-status 不显示图标
插件不显示文件状态图标，根本不是插件本身坏了，而是 Atom 的内置 Git 服务压根没连上。它不会报错，只会静默不工作。
验证方式很简单：按 Ctrl+Shift+P 打开命令面板，输入 Git: Toggle Git Tab。如果弹出 “No git repository found” 或空白面板，就坐实了底层断连。
- 确认项目根目录下存在
.git文件夹（不是子目录里有） - 打开 Atom 设置 → Core →
git.path，填入绝对路径，例如/usr/bin/git（macOS/Linux）或C:\Program Files\Git\bin\git.exe（Windows） - 改完必须重启 Atom——Git 状态不热加载
merge-conflicts 插件已实质失效，别再折腾
这个插件从 2023 年起就停更，Atom 1.70+ 版本中会直接崩溃或删错代码。它依赖的旧版 TextEditor.getBuffer() 接口已被移除，且无法识别 Git 2.30+ 的扩展冲突格式（比如带 ours/theirs 标签的多段冲突）。
实测表现包括：Accept Incoming 按钮点下去删掉整段函数、冲突块被跳过、控制台报 Cannot read property 'getBuffer' of undefined。
- 不要尝试降级 Atom 来兼容它——安全风险高，且新版 Git 已不向下兼容旧冲突标记
- 原生手动处理最稳：用
Ctrl/Cmd+F搜<<<<<< HEAD，选中整块（含三行标记），删掉不需要的分支内容，只留合法代码 - 删完务必检查是否残留
<<<<<<或>>>>>>，否则git add会失败并提示fatal: Path 'xxx' is in conflict
apm 安装 Git 相关插件失败的常见卡点
不是插件不行，是 apm 连不上源。国内直连 registry.npmjs.org 基本不可用，报 ENOTFOUND、ETIMEDOUT 都是典型表现。
- 运行
apm config set registry https://registry.npm.taobao.org/（注意不是npm config） - 执行
apm install --check，看到Checking for native build tools done才算真正就绪 - 若插件含原生模块（如
git-plus），装完要运行apm rebuild—— 它强制用 Atom 内置 Node（v12/v14）重编译，npm rebuild完全无效 - 仍失败？直接
git clone插件到.atom/packages/，进目录跑npm install
真正容易出问题的地方不在 Git 配置，而在删冲突时的手抖
Git 不会拦你删掉半行 return、多删一个花括号、漏掉注释末尾的 */。这类错误不会触发 git status 报警，但一运行就崩。
建议每次解决完冲突后，用 git diff --no-index <old> <new> 快速扫一眼变更范围，重点看删掉的是否全是标记行，保留的是否语法完整。
