sublime text 小地图(minimap)是右侧代码缩略图,非滚动条;st4 默认禁用,需在用户设置中添加 "show_minimap": true 才能启用,且仅此键名有效。

Sublime Text 小地图(Minimap)根本不是“滚动条”,别被名字误导
小地图(Minimap)是右侧那条代码缩略图,不是滚动条本身——它不替代、也不控制主编辑区的垂直滚动条。所谓“开启小地图预览”,实际就是让 Minimap 显示出来。而 Sublime Text 4(当前主流版本)默认完全禁用它,必须手动启用,否则无论你怎么拖、点、按 Alt+M 都不会出现。
为什么 Alt+M 按了没反应?先确认这三件事
这个快捷键不是全局开关,而是“触发显隐”的条件操作,失效原因几乎都出在状态上:
- 当前窗口没激活:鼠标点一下编辑区再试
- 菜单栏被隐藏了:按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 焦点不在编辑视图:比如你刚从命令面板、侧边栏或控制台切回来,
Alt+M就不响应 - 插件悄悄占用了快捷键:例如 Git 插件绑了
Ctrl + Shift + M,冲突时 Sublime 不报错也不提示
正确开启 Minimap 的唯一可靠写法:"show_minimap": true
别搜 minimap_enabled、enable_minimap 或 minimap_show——这些在 ST4 v4.4158+ 中全部无效,Sublime 会直接忽略。实测唯一被识别的键名是 show_minimap:
- 按
Ctrl + ,(Windows/Linux)或Cmd + ,(macOS)打开Preferences.sublime-settings - 确保修改的是右侧「User Settings」面板(不是左边 Default)
- 添加一行:
"show_minimap": true(注意:true是布尔值,不加引号) - 保存后立即生效,无需重启
- 验证是否真成功:按
Ctrl + `打开控制台,输入sublime.active_window().active_view().settings().get('show_minimap'),返回True才算到位
开了但显示异常?问题大概率不在 Minimap 设置本身
灰块、细线、无轮廓、点击跳转失灵……这些不是 show_minimap 没开,而是渲染层出了问题:
- 一片灰/没代码结构:主题文件(
.tmTheme)缺失minimap.background定义,得手动补 - 内容稀疏像细线:不是宽度不够,是
font_size太大(比如设为 14),调小到 12–13 行高降低后密度自然提升 - 点击不跳转:需额外配
"minimap_scroll_to_click": true;若同时开了"minimap_scroll_to_cursor": true,两者会竞争导致失效 - 右侧留白却不显示地图:检查是否装了旧版 Minimap 插件(非原生),卸载它再试;或者当前是空标签页,Minimap 不渲染无内容的视图
show_minimap 只管“画不画”,minimap_scroll_to_click 管“点不点跳”,minimap_width 管“宽不宽”——它们互不替代,也互不继承。改一个,别以为其他就自动对齐。











