sublime text 4无需安装minimap插件，因其已原生集成；启用只需在用户设置中添加"show_minimap": true，装旧插件会导致配置失效、显示异常或卡顿。
Sublime Text 4 不需要、也不应该安装任何叫 SublimeMinimap 的插件——它自带原生 Minimap，装了反而会冲突、失效、拖慢渲染。
为什么搜到的“SublimeMinimap 插件”不能用
你看到的所谓 SublimeMinimap 插件，基本是 Sublime Text 2/3 时代的遗留产物。ST4（v4.4158+）已将 Minimap 完全内置，不再依赖第三方包。装了这类插件后常见现象包括：
-
minimap_width、minimap_alpha等配置项完全不生效 - 右侧区域一片灰、空白，或出现双重缩略图重叠
- 拖拽 minimap 滚动时卡顿、跳帧，甚至导致整个编辑器假死
- 控制台报错：
reloading plugin Minimap.minimap后无响应
根本原因：两个 Minimap 实现同时注册 UI 组件，互相覆盖或竞争资源。
怎么确认你已经用了原生 Minimap
别看菜单有没有“Minimap”子项，直接查设置：
- 按
Ctrl + `打开控制台 - 输入：
sublime.active_window().active_view().settings().get('show_minimap') - 返回
True→ 已启用原生功能；返回None→ 根本没配；返回False→ 关闭状态
如果返回 None 或 False，说明你还没开启开关，不是插件没装对，而是压根没声明启用。
正确启用并调优原生 Minimap 的三步操作
打开 Preferences → Settings，只改右侧「User Settings」JSON：
- 加这一行：
"show_minimap": true（必须是布尔值true，不能加引号） - 可选增强：
"minimap_alpha": 0.7（让缩略图半透明，减少视觉干扰） - 别写
minimap_width—— ST4 中该字段已被移除，设了也无效
保存后立即生效。若仍不显示，90% 是当前主题缺失 minimap.background 定义，临时切到 Adaptive.sublime-theme 验证即可。
Alt+M 快捷键没反应？先检查这三件事
这个快捷键不是万能开关，依赖严格运行环境：
- 焦点必须在编辑区（光标正在代码里闪烁），不在侧边栏、命令面板或控制台时无效
- 菜单栏必须可见（误按
Ctrl + Shift + P→Toggle Menu隐藏后，快捷键即失效） - 可能被 Git、SideBarEnhancements 等插件静默劫持，且不提示冲突 —— 建议优先靠配置文件控制，而非依赖快捷键
真正容易被忽略的点是：Minimap 渲染依赖 GPU 加速和字体度量精度。在虚拟机、远程桌面或老旧集成显卡上，即使配置全对，也可能只显示黑块或空白——这时要加 "gpu_window_buffer": false，而不是反复调 minimap_alpha。
