Sublime Text 4中Minimap默认关闭，需在用户设置中配置"show_minimap": true才启用；Alt+M无效多因焦点不在编辑区、菜单栏隐藏或快捷键冲突；显示异常常由主题配色缺失、字体大小不当或GPU加速禁用导致。
Sublime Text 的“迷你地图”（Minimap）不是装完就自动可见的功能，它在 ST4 中默认关闭，必须手动开启 show_minimap 才能显示。
为什么按 Alt+M / Option+M 没反应？
这个快捷键只在编辑区有焦点、菜单栏可见时才生效，不是全局开关：
- 窗口未激活：点一下代码编辑区再试
- 菜单栏被隐藏：按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 焦点不在编辑区：比如当前在侧边栏、控制台或命令面板里，
Alt+M就不会触发 - 快捷键冲突：例如 Git 插件占用了
Ctrl + Shift + M，不会报错但静默失效
怎么正确开启 Minimap？
别搜 minimap_enabled 或 enable_minimap —— 这些键名在 ST4 中完全无效，Sublime 会直接忽略：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开Preferences.sublime-settings - 在右侧用户设置中添加一行：
"show_minimap": true - 保存后立即生效，无需重启
- 验证是否真启用：按
Ctrl + `打开控制台，输入sublime.active_window().active_view().settings().get('show_minimap')，返回True才算成功
Minimap 显示异常（灰、窄、没轮廓）怎么办？
调 minimap_width 解决不了本质问题，真正影响可读性的是配色、字体和主题支持：
- 一片灰/无代码轮廓：当前
.tmTheme配色方案没定义minimap.background，需手动补上 - 折叠标记糊成一团：根源是主题文件里
minimap.foldMarkscope对应的foreground值太浅，不是 Minimap 设置本身的问题 - 内容稀疏像细线：减小
font_size（如从 14 改为 12），行高降低后缩略图密度自然提升 - 颜色错位/高亮异常：Minimap 完全复用编辑区的语法高亮逻辑，问题出在语法定义或 scope 映射，跟 Minimap 配置无关
Minimap 的可用性高度依赖主题兼容性，哪怕 show_minimap 设为 true，如果当前主题没声明 minimap.* 相关样式，它也可能只是一条灰色竖条——这点容易被忽略，但恰恰是多数人调了半天却“看不见效果”的根本原因。
