atom右侧minimap非默认功能，须安装minimap-plus插件、确保文件被识别为代码（右下角非plain text）、并启用相关开关三者缺一不可。
Atom 编辑器右侧的代码缩略图（Minimap）不是默认开启的功能，必须装插件、确认文件类型、再检查启用状态——三者缺一不可。
minimap 插件装了但没显示？先看文件是否被识别为代码
Atom 的 minimap 只对“语法已启用”的文本文件生效，哪怕只是少个点号（比如 indexjs 而非 index.js），右下角显示 Plain Text，缩略图就直接不渲染。
- 点击编辑器右下角语言标识（如
Plain Text），手动切为对应类型，例如JavaScript、Python、HTML - 二进制文件（
.png、.pdf）、含非法 BOM 或编码损坏的文件，minimap会跳过处理 - 无扩展名的文件需手动指定语言，否则永远是
Plain Text，缩略图不会出现
该装哪个 minimap？别碰原版，用 minimap-plus
原 minimap 插件自 2021 年起停止维护，无法在 Atom 1.60+ 和 Electron 13+ 环境下正常安装或运行，常见报错包括：Error: The module 'minimap.node' was compiled against a different Node.js version。
- 唯一可用且持续更新的分支是
minimap-plus，适配 Atom 1.58+ 和主流系统 - 安装前确保已装 Python（2.7 或 3.6+），Windows 用户还需
npm install -g windows-build-tools - 终端执行：
apm install minimap-plus，装完无需重启，右下角出现小地图图标即成功
缩略图显示但没高亮/点不动？缺配套插件或开关关了
minimap 本体只负责绘制轮廓，当前行高亮、选中区域映射、点击跳转全靠独立插件和设置项控制。
- 要高亮当前行：必须装
minimap-highlight-selected，并在其设置页勾选Highlight current line - 点击缩略图跳转失效：进
minimap-plus设置页，确认Click to move cursor已启用 - 高亮太淡看不清：调
minimap-plus的Contrast（建议 0.8～1.0）和Opacity（建议 ≥0.95） - 同时启用了
minimap-cursorline和minimap-highlight-selected？功能重叠，样式易冲突，留一个即可
调窄宽度比调低 charHeight 更能缓解卡顿
大文件（>5000 行）下 minimap-plus 卡顿不是配置问题，是 Atom DOM 渲染架构限制。降低 Char Height 对性能提升有限，反而影响可读性。
- 优先调
Width：默认 120px，可降至 80～100px，减少重绘面积 - 禁用不用的衍生插件：如
minimap-git-diff、minimap-bookmarks，它们会叠加渲染层 - 滚动时定位偏移 1～3 行？这是实时同步延迟，非 bug，CPU 占用高或文件过长时必然发生
真正容易被忽略的是：Atom 的缩略图行为完全绑定于语言模式判定，而不是你“觉得它应该是代码”。哪怕只是文件名写成 config 而非 config.js，它就当纯文本处理——这点和 VS Code 不同，得手动干预，不能依赖自动识别。
