Sublime Text 4 默认关闭 Minimap,必须在右侧用户设置中添加 "show_minimap": true(布尔值、无引号、JSON合法)才能启用;Alt+M仅在编辑区有焦点且菜单可见时切换,验证需在控制台输入 sublime.active_window().active_view().settings().get('show_minimap') 返回True。

Sublime Text 4 默认关闭 Minimap,必须在用户设置中写 show_minimap: true 才能显示右侧小地图;写错键名、放错位置、被主题覆盖,都会导致“设置了却看不见”。
怎么确认并正确启用 show_minimap
它不是默认开着的,也不是插件——是 Sublime Text 4 原生功能,但默认值为 false。你打开用户设置文件时,大概率根本看不到这一行,得自己加:
- 按
Ctrl + ,(Windows/Linux)或Cmd + ,(macOS)打开Preferences.sublime-settings - 确保编辑光标落在右侧(Settings – User)面板,左侧 Default Settings 改了也无效
- 在花括号内添加:
"show_minimap": true(注意:true 不带引号,冒号后有空格,整行 JSON 合法) - 保存后无需重启,1–2 秒内右侧应出现窄条缩略图
验证是否真生效:按 Ctrl + ` 打开控制台,输入 sublime.active_window().active_view().settings().get('show_minimap'),返回 True 才算成功。
为什么 Alt + M 按了没反应
这个快捷键不是“启动器”,只是切换开关,且只在特定条件下工作:
- 当前窗口必须激活,且焦点在代码编辑区(不在侧边栏、控制台、命令面板)
- 菜单栏必须可见;若被隐藏,按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 快捷键可能被插件静默占用(比如 Git 插件常绑定
Ctrl + Shift + M),不报错也不提示 -
show_minimap本身未启用时,Alt + M也不会触发任何行为
开了却是一片灰/太细/完全不显示?优先查主题和配色
Minimap 渲染依赖主题定义的样式规则,不是靠 minimap_width 或 minimap_alpha 这类字段(它们在 ST4 中完全无效,写了也忽略):
- 一片灰或空白:当前配色方案(.tmTheme)缺失
minimap.background定义,临时切回Adaptive或Default主题可快速验证 - 缩略图像一条细线:不是宽度问题,而是
font_size过大导致行高撑开、密度下降;尝试调小到12或13 - 折叠标记糊成一团:由主题文件中的
minimap.foldMarkscope的foreground控制,不是用户设置能改的 - 右侧有缝隙或挤压感:可能是
overlay_scrollbar占位,加一行"overlay_scrollbar": "disabled"可释放空间
别碰 minimap_enabled 或其他变体键名
网上流传的 minimap_enabled、enable_minimap、minimap_show、draw_minimap 全部无效。Sublime Text 4 v4.4158+ 只识别 show_minimap 这一个键名:
- 拼错大小写(如
Show_Minimap)、多空格、漏引号、写成字符串"true",都会被静默忽略 - 它必须是布尔值,不能是数字
1或首字母大写的True - 某些旧教程或 AI 生成内容误传
minimap_enabled,实测返回None,说明 Sublime 根本没读到该配置
真正容易被忽略的点:Minimap 是否显示,和你用什么主题、是否启用了 overlay 滚动条、字体大小是否合理,关系远大于配置项本身——它看起来是个开关,实际是个“渲染链”的终点。


















