sublime text 默认关闭 minimap,需在用户设置中添加 "show_minimap": true 才启用;键名必须准确、位置必须在右侧用户配置区,保存后即时生效。

Sublime Text 默认开启 Minimap,但新装或重置配置后常被关闭;关键不是“怎么开”,而是“用对配置项”——show_minimap 是 Sublime Text 3/4 唯一被识别的开关,minimap_enabled 和 draw_minimap 都无效(后者甚至在最新版中已废弃)。
为什么改了设置没反应?检查这三处硬性条件
Minimap 不显示,90% 情况下不是功能坏了,而是配置没落到正确位置或写错键名:
-
show_minimap必须写在 User Settings(即 Preferences → Settings – User)里,左侧 Default Settings 是只读的,改了也白改 - 键名必须严格为
"show_minimap": true,拼成minimap_show、enable_minimap或漏掉引号,Sublime 会静默忽略 - 保存后无需重启,但若编辑区没焦点(比如刚从终端切回来),可能延迟 1–2 秒才渲染——可按
Alt + M(Win/Linux)或Option + M(macOS)强制触发一次显隐切换来验证
Sublime Text 4 用户特别注意:默认是关闭的
Sublime Text 4 安装后首次启动,show_minimap 默认为 false。这不是 Bug,是官方调整。所以新用户打开设置文件,大概率看不到这一行——得手动加:
{
"show_minimap": true
}
加完保存,右侧立刻出现窄条缩略图。如果仍不显示,先打开控制台(Ctrl + `),输入:
sublime.active_window().active_view().settings().get('show_minimap')
返回 True 才算真正生效。
开了之后卡顿或错位?这些参数能救场
大文件(如 >5MB JSON/日志)拖动 Minimap 卡顿,或某些主题下缩略图变灰、文字糊成一片,通常不是性能问题,而是渲染策略冲突:
-
"minimap_scroll_to_cursor": false—— 关闭自动居中,减少重绘,对长文件最有效 -
"minimap_show_buttons": false—— 隐藏缩放按钮,避免 UI 层叠干扰 -
"minimap_width": 100—— 默认值,建议别超120,否则挤压编辑区,尤其在 1366×768 分辨率下明显 - 若用 Origami、Material Theme 等插件/主题,它们可能覆盖 Minimap 渲染规则;临时禁用插件排查,确认后再针对性调整其配置
Minimap 的位置无法设为顶部或底部,只能左右固定;minimap_side 这类键名是 VSCode 的,Sublime 不认。真要左置,得改 .sublime-theme 文件,但风险高(错一个逗号就白屏),普通用户不如接受右侧默认布局。











