Sublime Text 4 默认不显示迷你地图，需在用户设置中手动添加 "show_minimap": true 才生效；Alt+M 仅切换开关，要求焦点在编辑区且菜单可见；第三方主题或 GPU 设置异常也会导致不可见。
Sublime Text 4 默认不显示迷你地图（Minimap），必须手动启用 show_minimap 才能看见右侧那条代码缩略图；不是插件、不用重启、改完即生效，但写错位置或键名会完全静默失效。
为什么按 Alt+M / Option+M 没反应
这个快捷键只是切换开关，不是“启动器”，它只在特定条件下才起作用：
- 当前窗口已激活，且焦点落在代码编辑区（点一下空白行再试）
- 菜单栏可见——如果被隐藏了，按
Ctrl + Shift + P输入Toggle Menu回车恢复 - 没被其他插件劫持：比如 Git 插件常占用
Ctrl + Shift + M，不会报错，但Alt+M就会静默失灵 - 没在侧边栏、控制台、命令面板等非编辑区操作时触发
show_minimap 必须写在用户设置里，且只认这一个键名
Sublime Text 4 唯一识别的配置项是 show_minimap，其他如 minimap_enabled、enable_minimap、minimap_show 全部无效，Sublime 会直接忽略整行，不警告也不报错。
- 打开设置：按
Ctrl + ,（Windows/Linux）或Cmd + ,（macOS） - 确保光标在右侧
Settings – User面板中（左侧 Default 是只读的，改了白改） - 补上这一行：
"show_minimap": true（注意：true 不加引号，冒号后有空格，JSON 格式合法） - 保存后 1–2 秒内右侧应出现窄条，若无反应，立即验证：
sublime.active_window().active_view().settings().get('show_minimap')返回True才算真正生效
开了还是看不见？先换回默认主题排查
很多第三方主题（如 Material Theme、Dracula、ayu）没定义 minimap.background 或把透明度设为 0，导致 Minimap “存在但不可见”。
- 菜单 →
Preferences → Color Scheme → Adaptive（或Default） - 再看右侧是否出现缩略图
- 如果换主题后出现了，说明原主题覆盖了渲染规则；可临时禁用主题或插件定位问题
- GPU 加速关闭也可能导致灰条或糊图：菜单 →
Preferences → Settings，确认"gpu_window_buffer": true（默认开启）
大文件卡顿或缩略图异常时该调哪些参数
Minimap 渲染本身不卡，卡的是自动居中和 UI 层叠。这些配套设置能稳住体验：
-
"minimap_scroll_to_cursor": false：关掉自动跟随光标，长日志/JSON 文件拖动流畅度明显提升 -
"minimap_show_buttons": false：隐藏缩放按钮，避免和滚动条重叠或干扰点击 -
"minimap_width": 100：默认值，别超过 120，小屏（如 1366×768）下过宽会挤压编辑区 - Minimap 只能固定在左右两侧，无法设为顶部或底部；方向由
"minimap_side"控制（仅部分主题支持，非官方标准）
最常被忽略的一点：Sublime Text 4 的 show_minimap 默认就是 false，不是“缺失”，所以你打开空的用户设置文件，根本看不到这一行——得自己加，且必须加对位置、拼对名字、格式合法。任何一步出错，它就彻底隐身，连错误提示都不会给你。
