必须安装minimap-plus，原版minimap自2021年起停更，不兼容atom 1.60+及electron 13+，常见报错包括node abi不匹配和模块找不到；minimap-plus是唯一持续更新、适配≥1.58版本的可用方案。
装哪个 minimap？别碰原版，只用 minimap-plus
原 minimap 插件自 2021 年起已停止维护，Atom 1.60+ 和 Electron 13+ 环境下无法安装或启动，常见报错包括：Error: The module 'minimap.node' was compiled against a different Node.js version、Cannot find module 'atom-space-pen-views'。唯一持续更新且兼容当前 Atom（≥1.58）的分支是 minimap-plus。
安装前必须满足：
- 已安装 Python 2.7 或 Python 3.6+（编译依赖）
- Windows 用户需提前运行
npm install -g windows-build-tools - 终端执行
apm install minimap-plus（比 GUI 安装更稳）
装完右下角出现小地图图标即成功，无需重启 Atom。
为什么缩略图不显示？先看右下角语言模式
Minimap 不是对“所有文本文件”生效，而是只对 Atom 已识别语法的文件渲染。最常见失效原因就是右下角显示 Plain Text——哪怕只是文件名少了个点（如 indexjs 而非 index.js），它就当纯文本跳过处理。
检查与修复步骤：
- 点击右下角语言标识，手动切换为
JavaScript、Python、HTML等具体类型 - 二进制文件（
.png、.pdf）、含非法 BOM 或 UTF-16 编码的文件，minimap 直接忽略 - 无扩展名文件必须手动指定语言，否则永远是
Plain Text - 确认插件状态是
Installed而非Install，并已勾选Enable
怎么让当前行/选中代码在缩略图里高亮？
minimap-plus 本体只画结构块（空行、缩进、密度），不提供高亮功能。必须额外安装 minimap-highlight-selected 插件，并手动开启开关：
- 安装后进入其设置页，必须勾选
Highlight current line和Highlight selected text - 若同时启用了
minimap-cursorline，建议禁用——两者功能重叠，容易样式冲突或高亮消失 - 高亮太淡？调
minimap-plus设置里的Contrast（推荐 0.8～1.0）和Opacity（推荐 ≥0.95）
注意：minimap-highlight-selected 对 >10k 行文件有轻微卡顿，若编辑明显延迟，可关掉 Highlight selected text，只保留行高亮。
大文件下卡顿、定位偏移、点击跳转无效？不是配置问题
打开 >5000 行的 JS/TS 文件时，minimap-plus 卡顿甚至拖慢光标响应，这不是参数没调对，而是 Atom 架构限制：它靠 DOM 渲染而非 Canvas，重绘成本随行数指数上升。
缓解手段有限但有效：
- 优先调窄
Minimap Width（默认 120px → 80～100px），比降低Char Height更能减少重绘面积 - 禁用不用的衍生插件：
minimap-git-diff、minimap-bookmarks、minimap-selection—— 它们叠加渲染层，加重负担 - 点击跳转失效？确认
minimap-plus设置页中Click to move cursor已启用 - 滚动时定位偏移 1～3 行？这是实时同步延迟，CPU 高负载或长行（如单行 JSON）下必然发生，非 bug
真正容易被忽略的是：minimap 的行为完全依赖 Atom 对文件类型的判定，而不是你“觉得它应该是代码”。哪怕语法主题再漂亮，只要右下角是 Plain Text，缩略图就不存在——这点和 VS Code 逻辑不同，得手动干预语言模式。
