必须用minimap-plus而非原版minimap，因后者不兼容Atom 1.60+；minimap-git-diff仅渲染Git已跟踪文件的未暂存（红）和已暂存（绿）改动，失效主因是文件未被Git跟踪、项目根目录≠仓库根目录、语言模式为Plain Text、或文件为二进制/编码异常。

装 minimap-git-diff 之前，先确认你用的是 minimap-plus ——原版 minimap 在 Atom 1.60+ 上根本不能用，插件会静默失效或报 Error: The module 'minimap.node' was compiled against a different Node.js version。

为什么 minimap-git-diff 不显示颜色块？

它不主动检测变更，只渲染 Git 已跟踪文件的两类改动：工作区未暂存（红色）、已暂存（绿色）。常见失效原因不是插件没装好，而是：

• 当前文件没被 git add 过，git status 里压根不出现
• Atom 当前项目根目录 ≠ Git 仓库根目录（用 git rev-parse --show-toplevel 验证）
• 右下角语言模式是 Plain Text ——哪怕只是 indexjs 少了个点，插件就跳过
• 文件是二进制（.png、.pdf）或含非法 BOM / UTF-16 编码

怎么让 Git 差异色块真正显示出来？

光装插件不够，得对齐三个关键状态：

Pilot Digital Twin Setup

部署一个包含 4 个智能体（agent）的数字孪生平台。在以下情况下使用该技能： 1. 用户希望为物理资产监控与预测性维护等场景搭建数字孪生系统……

下载

• 确保 minimap-plus 已启用，且设置页中 Click to move cursor 勾选（否则点击色块无法跳转）
• minimap-git-diff 安装后默认开启，但若颜色太淡，调高 minimap-plus 的 Contrast（建议 0.9）和 Opacity（建议 0.98）
• 禁用 minimap-cursorline 和 minimap-highlight-selected 的 Highlight selected text ——它们会覆盖色块样式，导致红/绿变灰甚至消失

滚动时色块偏移 1～2 行，是 bug 吗？

不是。插件靠 git diff 输出的 hunk 起始行 + 行数估算位置，不是逐行比对。尤其在长文件、混用中文/emoji 时更明显。缓解方式有限：

• 保持 minimap-plus 的 Char Height 别调太小（否则密度失真加剧偏移）
• 把 Minimap Width 从默认 120px 降到 80～100px，能小幅改善同步延迟
• 真正影响定位准确性的，是 Atom 自身 DOM 渲染机制 ——它没法像 Canvas 那样像素级对齐，这点必须接受

最容易被忽略的，是 Atom 对“代码文件”的判定完全依赖右下角语言模式，而不是文件名或内容。哪怕你刚 git add 了 config，只要没手动切到 YAML 或 INI，minimap-git-diff 就当它不存在。