sublime text 4中minimap默认关闭，需在用户设置中配置"show_minimap": true才启用；alt+m无效常因焦点不在编辑区、菜单栏隐藏或快捷键冲突；显示异常多由主题配色缺失、字体大小不当或gpu加速禁用导致。
Sublime 的右侧缩略图（Minimap）不是“装了就能用”的功能，它在不同版本中默认状态不一致：ST3 多数情况默认开启，ST4 默认关闭。是否显示，取决于 show_minimap 是否为 true，且未被主题或插件覆盖。
为什么按 Alt+M / Option+M 没反应？
这个快捷键只在编辑区有焦点、菜单栏可见时才有效，不是“全局开关”：
- 窗口没激活：点一下代码区域再试
- 菜单栏被隐藏：按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 快捷键冲突：比如 Git 插件占用了
Ctrl + Shift + M，不会报错，但静默失效 - 你根本没在编辑区——比如焦点在侧边栏或控制台，
Alt + M就不会触发
用户设置里该写 show_minimap 还是 minimap_enabled？
以 Sublime Text 4（2026 年主流版本）为准：show_minimap 是唯一生效的键名。网上常见的 minimap_enabled 或 enable_minimap 都是无效配置，Sublime 会直接忽略。
正确操作：
- 按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS）打开Preferences.sublime-settings - 在右侧用户设置中添加：
"show_minimap": true - 保存后立即生效，无需重启
- 验证是否真正启用：按
Ctrl + `打开控制台，输入sublime.active_window().active_view().settings().get('show_minimap')，返回True才算成功
缩略图显示了但一片灰/太窄/没轮廓？别调宽度，查配色和字体
minimap_width 只控制像素宽度（默认 100），调大可能挤占编辑区，但解决不了“看不清”的本质问题：
- 一片灰/无代码轮廓：当前配色方案（
.tmTheme）没定义minimap.background，需手动补上 - 折叠标记糊成一团：由
minimap.foldMarkscope 控制，要改的是主题文件里的foreground值，不是 Minimap 设置 - 内容稀疏、像条细线：减小
font_size（如从 14 改成 12），行高压缩后缩略图密度自然提升 - 颜色怪、高亮错位：Minimap 完全复用编辑区语法高亮逻辑，根源在语法定义或 scope 映射，不在 Minimap 配置本身
主题或插件让 Minimap 消失了？优先切换回默认主题验证
Minimap 是原生功能，不依赖插件，但以下两类东西会遮挡或禁用它：
- 第三方主题（如 Material Theme、ayu）常覆盖
minimap_control样式规则，导致渲染为空白——临时切回Adaptive或Default主题，能立刻判断是不是主题问题 - UI 类插件（如
Origami、BracketHighlighter）可能监听 Minimap 状态做布局调整，关掉后可能出现右侧留白或错位 - 高 DPI 场景下，
overlay_scrollbar和 Minimap 共享右侧空间，加一行"overlay_scrollbar": "disabled"可释放横向余量
最常被忽略的一点：你看到的“没开启”，大概率是主题把背景设成了全透明，或者显卡驱动在远程桌面中禁用了 OpenGL 加速——这时候调 show_minimap 没用，得查 gpu_window_buffer 或换本地环境验证。
