minimap插件装完即生效，无需重启atom，但需确认已安装并启用、文件类型正确识别；打开settings→install搜索minimap，状态为“installed”即成功，右下角语言模式须非plain text。
Minimap 插件装完就生效，不需要重启 Atom，也不需要额外配置——但前提是文件类型被正确识别、插件确实已安装且启用。
怎么确认 minimap 真的装好了
打开 Atom 设置（Ctrl + , 或 Cmd + ,），进入 Install 标签页，搜索 minimap。如果状态显示为 Installed，说明已装好；如果还是 Install 按钮，点它安装即可。别信“自动启用”——有些旧版 Atom 或离线安装后可能默认禁用，需手动勾选 Enable 复选框。
- 离线安装时，必须进
~/.atom/packages/minimap目录执行npm install，否则插件可能加载失败，界面无反应 - 用
apm install minimap命令安装更稳，比 GUI 点击少出错 - 装完不显示？先看右下角语言模式是不是
Plain Text；如果是，点它手动切到JavaScript、Python等具体语言
为什么代码文件右侧没出现缩略图
最常见原因是 Atom 没把当前文件当“可编辑文本”处理。二进制文件、无扩展名文件、UTF-16 编码或 BOM 异常的文件，都会导致 minimap 拒绝渲染。
- 检查文件路径和扩展名：
.js、.py、.html等常规扩展名基本都支持；.log、.out、无后缀文件默认不触发 - 用
file -i filename（Linux/macOS）或 PowerShell 的Get-Content -Encoding查编码，非 UTF-8 且带 BOM 的文件容易卡住 minimap - 临时测试：新建一个
test.js，写两行console.log(1)，保存后看 minimap 是否出现——能出就是原文件有问题
怎么让选中代码在 minimap 里高亮
单独装 minimap-highlight-selected 不够，安装后必须进它的设置页，手动开启两个开关：Highlight current line 和 Highlight selected text，缺一不可。
- 如果同时启用了
minimap-cursorline，它会和minimap-highlight-selected冲突，导致高亮错位或消失，建议只留后者 - 高亮颜色由当前语法主题决定，改主题后可能变淡或看不见，可进
minimap-highlight-selected设置调Highlight color覆盖 - 该插件对大文件（>10k 行）有轻微卡顿，若编辑时明显延迟，可关掉
Highlight selected text仅保留行高亮
缩略图位置/大小调不了？检查配置项拼写
Atom 的 minimap 配置项是 JSON 格式，写在 config.cson 里，不是 settings.json。常见错误是把 minimap.displayMinimapOnLeft 写成 minimap.onLeft，或把 minimap.charHeight 拼成 charHeigth——拼错就无效，且不会报错。
- 推荐直接在 Settings → Packages → minimap → Settings 页面改，避免手写配置出错
- 宽度单位是像素，设
200太宽会挤占编辑区；120是较平衡值 - 设
"minimap.displayMinimapOnLeft": true后，记得关掉所有窗口再重开，部分版本不热更新位置
真正麻烦的不是装不上，而是它“看起来装了却不动”——问题往往藏在语言模式、文件编码、插件冲突这三处，逐一排除比重装快得多。
