必须将"show_minimap": true写入用户设置（preferences → settings – user）才生效，左侧默认设置只读且无效；键名拼写、引号、大小写及json格式错误均导致静默忽略；控制台执行sublime.active_window().active_view().settings().get('show_minimap')返回true方为成功。
show_minimap必须写在用户设置里，不是默认设置
Sublime Text 的 show_minimap 只在用户配置（Preferences → Settings – User）中生效。左侧的 Default Settings 是只读的，改了也白改，重启后还会被覆盖。新装 Sublime Text 4 后，这个键根本不会出现在用户设置里——得手动加。
常见错误现象：
- 改完设置没反应，控制台查
sublime.active_window().active_view().settings().get('show_minimap')返回None或false - 误把配置写进插件自己的 settings 文件（比如 Package Control 或 Theme 的配置），完全不触发 Minimap 渲染
正确做法：
- 按
Ctrl + ,（Win/Linux）或Cmd + ,（macOS）打开设置面板 - 确保光标落在右侧（User Settings）区域
- 补上这行：
"show_minimap": true（注意引号、冒号、小写true，别写成"True"或1） - 保存，无需重启，1–2 秒内右侧应出现窄条缩略图
别信“minimap_enabled”或“minimap_show”，Sublime 只认 show_minimap
网上很多教程写的 minimap_enabled、minimap_show、enable_minimap 全是错的。Sublime Text 3/4 唯一识别的键名就是 show_minimap。拼错一个字母、大小写不对、漏引号，它都会静默忽略整行，不报错也不警告。
验证方式很直接：打开控制台（Ctrl + `），输入：
sublime.active_window().active_view().settings().get('show_minimap')
返回 True 才算真正加载成功；返回 None 表示键名无效或没写对位置。
特别提醒：Sublime Text 4 安装后默认值是 false，不是缺失——所以你打开空的用户设置文件，看不到这一行是正常的，不是 bug。
开了还是不显示？先切回默认主题排查
Minimap 不显示，90% 不是功能坏了，而是被主题或插件盖住了。比如 Material Theme、ayu、Dracula 这类第三方主题，常把 minimap_control 的背景设为全透明，或者压根没定义 minimap.background，结果缩略图“存在但不可见”。
快速排查步骤：
- 菜单栏 → Preferences → Color Scheme → Adaptive（或 Default）
- 再看右侧有没有缩略图出现
- 如果有了，说明是当前主题的问题；如果还没，再回头检查
show_minimap是否生效
某些插件也会干扰，比如 Origami（分屏）、BracketHighlighter 的高亮模式，它们可能监听 Minimap 状态做布局计算，导致右侧留白或渲染中断。临时禁用插件再试，比反复调配置更省时间。
宽度、透明度、卡顿这些都得手写，没有图形界面可调
Sublime 没有滑块、下拉菜单或右键菜单来调 Minimap 大小或模糊度。所有视觉和行为参数都得手动加进用户设置：
-
"minimap_width": 120—— 默认 100，单位像素；别超 150，否则在 1366×768 屏幕上明显挤压编辑区 -
"minimap_alpha": 0.7—— 透明度范围 0.0–1.0；设太低（如 0.3）会让鼠标悬停定位困难 -
"minimap_scroll_to_cursor": false—— 关闭自动居中，大文件（>5MB 日志）滚动时卡顿会明显缓解 -
"minimap_draw_highlighted_text": false—— 关掉当前行高亮，减少视觉干扰，适合密集阅读
改完保存即生效，不用重载设置或重启。但要注意：minimap_side、minimap_position 这类键名是 VSCode 的，Sublime 不识别，写了也白搭。
真正难搞的是位置——Minimap 只能左右固定，不能上下或拖拽。想左置？得改 .sublime-theme 文件，加 "content_alignment": "left"，但错一个逗号就白屏。普通用户不如接受右侧默认布局，把精力放在代码导航效率上更实在。
