minimap插件默认不高亮当前行，需安装启用minimap-highlight-selected插件，并开启highlight current line选项；点击缩略图跳转需确保click to move cursor已启用；高亮过淡可调contrast至0.8～1.0、opacity至0.95+。

Minimap 插件没高亮当前行？检查 minimap-highlight-selected 是否启用

Atom 默认的 minimap 插件只显示代码轮廓，不带语法高亮或当前行标记。真正负责“高亮当前行”和“选中区域映射”的是独立插件 minimap-highlight-selected —— 它不是内置功能，必须手动安装并启用。

常见错误现象：minimap 显示正常，但鼠标在编辑区移动时缩略图里完全没反应，像一张静态快照。

• 打开 Atom 设置 → Install → 搜索 minimap-highlight-selected → 点击 Install
• 安装后务必勾选插件设置页的 Highlight current line 和 Highlight selected text
• 如果用了 minimap-cursorline，它和 minimap-highlight-selected 功能重叠，建议只留一个，避免样式冲突

缩略图里点一下就跳转不到对应代码？确认 minimap 的点击行为没被禁用

Minimap 默认支持点击跳转：在缩略图上单击任意位置，光标会瞬间定位到编辑器对应行。但这个行为容易被误关，尤其在更新插件或重装后。

使用场景：快速浏览长文件（比如 2000 行的配置脚本），靠缩略图颜色块识别逻辑区块，再点进去看细节。

• 进入 minimap 插件设置页，检查 Click to move cursor 是否开启（默认是开的，但有人为省电/防误触关掉）
• 若仍无效，可能是主题 CSS 覆盖了点击区域——临时切换成 Atom 自带的 One Dark UI 主题测试是否恢复
• 某些远程开发插件（如 atom-remote-ftp）会劫持鼠标事件，关闭它们再试

高亮颜色太淡或和背景融在一起？调整 minimap 的 contrast 和 opacity

Minimap 的视觉效果高度依赖主题配色和显示器亮度，尤其在深色主题下，highlight-selected 的默认浅黄底色可能几乎不可见。

参数差异：contrast 控制缩略图整体明暗对比度（值越大越锐利），opacity 控制背景透明度（影响高亮色块是否被“吃掉”）。

• 在 Atom 设置 → Packages → minimap → Settings 中，把 Contrast 调到 0.8～1.0，Opacity 设为 0.95 或更高
• 不要盲目调 0.0 的 opacity——那会让高亮色块彻底消失，因为缩略图本身是半透明渲染的
• 如果用了 minimap-pigments（支持颜色预览），它的高亮优先级高于 highlight-selected，此时调 contrast 更有效

滚动太快导致缩略图定位偏移？这是 Atom 渲染延迟，不是 bug

当文件超长（>5000 行）或 CPU 占用高时，Minimap 的实时同步会出现 1～3 行的视觉延迟：拖动编辑区滚动条后，缩略图上的高亮条滞后半秒才跟上。

性能影响：这不是插件缺陷，而是 Atom 基于 Electron 的渲染机制决定的——缩略图是异步生成的位图，不参与主编辑器的 DOM 流程。

• 降低 minimap 设置里的 Smooth scrolling（关掉可减少一帧延迟）
• 禁用非必要插件，特别是那些监听 cursor:move 事件的（比如旧版 minimap-autohider）
• 别指望它做精确调试——它只是导航辅助，真要定位某行请用 Ctrl+G 输入行号

真正难搞的是多光标 + Minimap 高亮的叠加逻辑：它只响应主光标，其他光标在缩略图里不会体现。这点文档不提，但写脚本时很容易卡住半天。