minimap-git-diff未显示差异色块，是因为插件仅渲染Git跟踪文件的未暂存或已暂存改动，需确认文件被Git跟踪、位于仓库根目录下、语言模式正确且非二进制文件，否则静默不渲染。
minimap-git-diff 装了但没显示差异色块？先确认 Git 状态和文件路径
插件本身不主动“检测变更”，它只渲染 git diff --cached 和工作区未暂存的改动——如果当前文件没被 Git 跟踪、没在工作区修改、或不在当前仓库根目录下，缩略图里就什么都不会标。常见现象是：明明改了代码，minimap 右侧却一片灰。
- 用终端执行
git status，确认该文件出现在 “modified:” 列表里 - 检查 Atom 当前项目根目录是否等于 Git 仓库根目录（
git rev-parse --show-toplevel），否则插件找不到 .git 目录，直接放弃渲染 - 无扩展名文件或右下角显示
Plain Text→minimap-git-diff不生效，必须手动切语言模式 - 二进制文件（如
.png）或含非法 BOM 的 UTF-16 文件会被跳过，不报错也不渲染
为什么只显示绿色/红色块，却不标具体哪行改了？
minimap-git-diff 默认只画区块轮廓，不映射到精确行号——它靠的是 git diff 输出的 hunk 起始行 + 行数估算位置，不是逐行比对。所以滚动时可能偏移 1～2 行，尤其在长文件或混合宽字符（如 emoji、中文）场景下更明显。
- 确保
minimap-plus已启用Click to move cursor，否则点击色块无法跳转到对应变更处 - 不要同时启用
minimap-cursorline和minimap-highlight-selected，它们会覆盖minimap-git-diff的颜色层，导致色块变淡甚至消失 - 调高
minimap-plus的Contrast（建议 0.9）和Opacity（建议 0.98），否则浅绿/浅红在暗色主题下几乎看不见 - Git 暂存区为空时，只显示未暂存的改动；执行
git add -u后，色块会从红色（unstaged）变成绿色（staged）
和其他 minimap 插件共存时样式打架怎么办？
多个插件往同一 DOM 元素注入样式，容易互相覆盖。最常冲突的是 minimap-highlight-selected 和 minimap-git-diff ——前者高亮选中区域，后者高亮 Git 变更，但两者都操作 .minimap-selection 类，最终谁后加载谁赢。
- 优先禁用
minimap-cursorline：它和minimap-highlight-selected功能重复，且默认样式权重更高，常压掉 Git 色块 - 若需同时保留高亮与 diff，进
minimap-highlight-selected设置页，把Highlight selected text关掉，只留Highlight current line - 所有 minimap 衍生插件（如
minimap-bookmarks、minimap-find-and-replace）都建议按需启用，开得越多，主线程渲染压力越大，色块响应延迟越明显 - 大文件（>5000 行）下，
minimap-git-diff渲染会降帧保主编辑器流畅，这不是 bug，是 Atom 的 DOM 架构限制
apm install minimap-git-diff 后仍报错或加载失败？
错误通常出在依赖链或 Node.js 版本错配，尤其是 Atom 1.60+ 用户。原版 minimap-git-diff 已停止维护，必须用适配分支。
- 别装
minimap-git-diff原包，改用minimap-plus-git-diff（它是minimap-plus官方推荐配套）：apm install minimap-plus-git-diff - 装完检查
~/.atom/packages/minimap-plus-git-diff/package.json，确认"engines": {"atom": ">=1.58.0"}匹配你当前 Atom 版本 - Windows 用户若遇到
node-gyp编译失败，先运行npm install -g windows-build-tools再重试 - 离线安装时，进插件目录执行
apm install（不是npm install），否则模块路径不对，Atom 找不到插件入口
minimap-git-diff 的渲染完全依赖 Git 仓库状态和 Atom 对文件类型的判定，而不是你“刚保存了文件”这个动作。哪怕只是路径多了一层 ../，或文件编码用了 UTF-16 LE，它就静默退出，不提示、不报错、也不 fallback。 
