Minimap滚动不同步不是bug，而是Atom渲染延迟的必然表现；因采用比例映射而非逐字符定位，>5000行文件或高CPU时会出现1～3行偏移，属设计限制。
Minimap 滚动不同步？不是 bug，是 Atom 渲染延迟的必然表现
Atom 的 minimap-plus 无法做到 VS Code 那种逐像素/逐字符级同步，它靠比例映射计算位置——滚动时出现 1～3 行偏移，尤其在 >5000 行文件或 CPU 占用高时，属于设计限制，不是配置错误或插件故障。
常见错误现象：拖动编辑区滚动条后，缩略图里高亮块“慢半拍”才跟上；鼠标悬停缩略图某处，光标跳转后实际行号偏差一两行。
- 这不是
Click to move cursor开关没开，也不是主题 CSS 覆盖导致 - 临时缓解方法：降低
minimap-plus的Width（建议 80–100px），减少重绘面积，能略微改善响应节奏 - 真正起效的是关掉非必要衍生插件，比如
minimap-git-diff、minimap-bookmarks，它们每帧都要叠加渲染层，加重主线程负担
点击缩略图跳转失效？先确认 Click to move cursor 是否启用
minimap-plus 默认开启点击跳转，但这个开关容易被手动关闭或被其他插件干扰。跳转失败 ≠ 插件没装好，大概率是行为被禁用。
- 进 Settings → Packages →
minimap-plus→ Settings，检查Click to move cursor是否勾选 - 若已启用仍无效，临时切换为
One Dark UI主题测试——某些第三方 UI 主题（如 Material Theme）会覆盖.minimap区域的 pointer-events - 远程开发类插件（如
atom-remote-ftp）可能劫持鼠标事件，可逐一禁用验证
高亮当前行不显示？minimap-highlight-selected 必须手动开启两个开关
minimap-plus 本体只画轮廓，不处理高亮。所谓“当前行高亮”完全依赖 minimap-highlight-selected 插件，且安装后默认不启用关键功能。
- 装完插件后，必须进其 Settings 页面，同时勾选
Highlight current line和Highlight selected text - 如果还启用了
minimap-cursorline，请禁用它——两者功能重叠，CSS 样式冲突会导致高亮错位或消失 - 高亮色太淡？调
minimap-plus的Contrast到 0.8～1.0、Opacity到 0.95+；不要调Opacity到 0.0，那会让高亮彻底不可见
缩略图根本不出现在右侧？三要素缺一不可
Minimap 不显示，90% 是因为 Atom 没把当前文件当代码处理。它不看文件名“像不像代码”，只认语言模式识别结果。
- 看右下角状态栏：如果是
Plain Text，点它手动切为JavaScript、Python等具体语言；少个点号（如indexjs而非index.js）就会卡在这里 - 二进制文件（
.png、.pdf）、无扩展名文件、UTF-16 编码或 BOM 异常的文件，minimap-plus直接跳过渲染 - 必须装
minimap-plus（不是原版minimap），原版自 2021 年起已停止维护，在 Atom 1.60+ 上会报Error: The module 'minimap.node' was compiled against a different Node.js version
真正容易被忽略的是：Atom 的缩略图行为完全绑定于语言模式判定，而不是你“觉得它应该是代码”。哪怕只是扩展名拼错一个字符，它就当纯文本处理，缩略图直接消失——这点和 VS Code 不同，得手动干预语言模式。
