Sublime Text 4 默认不显示小地图，需手动设置 "show_minimap": true（非 minimap_enabled 等无效键名），且仅在编辑区有焦点、菜单栏可见时 Alt+M 才生效；小地图异常多因主题缺失 minimap.background 定义。
Sublime Text 4 默认不显示右侧代码小地图（Minimap），必须手动启用 show_minimap 才能看到——不是插件没装、不是快捷键坏了，而是开关根本没打开。
为什么按 Alt+M / Option+M 没反应？
这个快捷键只在编辑区有焦点、菜单栏可见时才生效，不是全局热键：
- 窗口没激活：点一下代码区域再试
- 菜单栏被隐藏：按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 焦点不在编辑区：比如当前选中了侧边栏、控制台或命令面板，
Alt + M就不会触发 - 快捷键被插件静默占用：例如 Git 插件绑了
Ctrl + Shift + M，冲突时不报错也不提示
用户设置里该写 show_minimap 还是 minimap_enabled？
以 Sublime Text 4（2026 年主流版本）为准：show_minimap 是唯一有效的键名。网上常见的 minimap_enabled、enable_minimap、minimap_show 全部无效，Sublime 会直接忽略。
正确操作：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开Preferences.sublime-settings - 确保修改的是右侧「User Settings」（不是左侧 Default）
- 添加一行：
"show_minimap": true（注意：布尔值true不带引号，引号只包 key 和字符串值） - 保存后立即生效，无需重启
验证是否真正生效：按 Ctrl + ` 打开控制台，输入 sublime.active_window().active_view().settings().get('show_minimap')，返回 True 才算成功。
小地图显示了但一片灰/太窄/没轮廓？别调 minimap_width
minimap_width 是个常见误解——它在 Sublime Text 4 中**不生效**，官方文档和源码均未定义该配置项。你看到的“宽度”其实是编辑区字体密度和窗口尺寸共同决定的视觉结果。
真正影响可读性的关键点：
- 一片灰、无代码结构：当前配色方案（.tmTheme）缺少
minimap.background定义，需手动补上 - 折叠标记糊成一团：由主题文件里的
minimap.foldMarkscope控制，改的是foreground值，不是 Minimap 设置 - 内容稀疏像细线：减小
font_size（如从 14 改为 12），行高压缩后缩略图自然更密集 - 颜色错位、高亮异常：Minimap 完全复用编辑区的语法 scope 和配色逻辑，问题根子在语法定义或主题映射，不在 Minimap 配置本身
主题或插件让小地图“消失”了？先切回默认主题验证
Minimap 是原生功能，不依赖插件，但 Material Theme、Dracula、Ayu 等第三方主题常把 minimap.background 设为全透明，或压根没定义该 scope，导致它“存在但不可见”。
快速排查步骤：
- 菜单 →
Preferences → Color Scheme → Adaptive（或Default） - 再看右侧是否出现缩略图
- 如果出现了，说明是当前主题的问题；如果还没，再回头检查
show_minimap是否写对位置、格式、大小写
特别注意：Sublime Text 4 安装后 show_minimap 的默认值是 false，不是缺失——空的用户设置文件里看不到这一行，是正常现象，不是 bug。
