atom中minimap未显示主因是文件未被识别为代码：无扩展名、扩展名未关联语法（右下角显示plain text）、文件为二进制或含非法bom；需手动切换语言模式、确认插件已启用并安装成功。
装完 minimap 就能用，但没反应、不高亮、点不动——基本不是插件坏了，而是配置没对上或依赖缺了。
为什么装了 minimap 却没显示？
Atom 默认不带 minimap，但装完后它只对“被识别为文本文件”的内容生效。常见失效原因：
- 文件无扩展名，或扩展名未被 Atom 关联到任何语法（右下角显示
Plain Text）→ 点击右下角语言模式，手动切为JavaScript、Python等对应类型 - 文件是二进制（如
.png、.pdf）或编码异常（如含非法 BOM）→minimap直接跳过渲染 - 插件状态是 “Install” 而非 “Installed” → Settings → Install → 搜
minimap，确认已安装并启用 - 重启 Atom 不必要，但改完设置后需保存才能生效
怎么让缩略图里高亮当前行和选中代码？
minimap 本体不提供高亮功能，必须额外装 minimap-highlight-selected 插件，并开启对应选项：
- Settings → Install → 搜索
minimap-highlight-selected→ Install - 安装后进入该插件设置页，勾选
Highlight current line和Highlight selected text - 如果同时启用了
minimap-cursorline，建议禁用它——两者功能重叠，容易样式打架 - 若高亮太淡，调
Contrast到 0.8～1.0、Opacity到 0.95+ 更易辨识
点击缩略图跳转无效或卡顿怎么办？
跳转依赖 Click to move cursor 开关，卡顿则多因渲染负担而非 bug：
- 检查
minimap主插件设置页，确认Click to move cursor已启用 - 大文件（>10MB）或同时开了太多 minimap 衍生插件（如
minimap-git-diff、minimap-bookmarks）会拖慢响应 → 关掉不用的插件可明显改善 - Atom 的
minimap是按比例定位，不是逐字符映射；所以滚动精度不如 VS Code 原生版，尤其在超长行或混合宽字符时 - 调窄宽度（
minimap.width）比降低charHeight更有效缓解卡顿
真正容易被忽略的是：minimap 的行为高度依赖 Atom 对文件类型的判定，而不是你“觉得它应该是代码”。哪怕只是少了一个点号（比如把 index.js 写成 indexjs），它就当纯文本处理，缩略图直接消失——这点和 VS Code 不同，得手动干预语言模式。
