show_minimap 必须设为 true 才能启用缩略图，正确写法是 "show_minimap": true（布尔值、不加引号、冒号后空格），需手动添加到用户设置中；常见错误包括键名错误、误改默认设置、JSON 语法错误等。
show_minimap 必须设为 true，否则右侧根本不会出现缩略图
Sublime Text 4 默认关闭 Minimap，不是“没装插件”或“版本太低”，而是开关压根没打开。你打开 Preferences.sublime-settings 用户设置文件时，大概率看不到这一行——得自己加。
正确写法只有一条："show_minimap": true（注意：true 是布尔值，不加引号；冒号后有空格；必须放在右侧 Settings – User 面板里）。
常见错误：
- 写成
"minimap_enabled": true或"enable_minimap": true—— Sublime Text 4 完全忽略这些键名 - 粘贴到左侧 Default Settings 面板 —— 改了也无效
- 末尾多加逗号，导致 JSON 解析失败，整个设置不生效
验证是否真启用：按 Ctrl + ` 打开控制台，输入 sublime.active_window().active_view().settings().get('show_minimap')，返回 True 才算成功。
minimap_width 控制像素宽度，但主题可能覆盖它
minimap_width 是唯一能调的像素级宽度参数，单位是 px，不是百分比，也不支持拖拽缩放。默认值是 100，建议范围 80–150；超过 150 会明显挤压编辑区，尤其在 1366×768 或高 DPI 屏幕上。
但改了没变化？别急着怀疑配置，先查三处：
- 执行
sublime.active_window().active_view().settings().get('minimap_width')看返回值，确认是不是被插件运行时重写了 - 当前主题（如 Material、Ayu）的
.sublime-theme文件里，minimap_controlrule 是否硬编码了content_width或width - 禁用
Origami、BracketHighlighter这类 UI 插件，它们常监听 Minimap 状态并强制重设尺寸
minimap_opacity 和 minimap_hover_opacity 要一起配，单改一个没用
Minimap 的“视觉缩放感”其实靠透明度调节：常态下太透看不清结构，悬停时太实又跳变。两个参数必须协同设置才有效。
推荐组合：
-
"minimap_opacity": 0.75—— 常态下足够看清代码块轮廓，又不遮挡右侧滚动条 -
"minimap_hover_opacity": 0.95—— 悬停时不突兀变实，定位更平滑
注意：minimap_alpha 是旧名，Sublime Text 4 中已弃用；minimap_scale_text 可设为 false 让缩略图更紧凑，适合高 DPI 屏幕，但它不影响文字识别精度，只改变渲染密度。
一片灰、细线状、点不动？问题不在设置，而在主题和配色方案
Minimap 渲染完全复用编辑区的语法 scope 和配色逻辑。它显示异常，90% 是主题或配色方案缺定义，不是你配置错了。
快速验证方法：
- 切回
Adaptive或Monokai默认主题，如果立刻正常，说明当前主题有问题 - 检查当前
.tmTheme文件是否包含minimap.background定义；缺失就会一片灰 - 缩略图像一条细线？不是
minimap_width太小，而是font_size过大撑开了行高；试试把font_size从 14 改成 12 - 拖不动或高亮不同步？这是 Sublime 的空闲渲染策略，不是卡顿；若延迟超 1 秒，关掉
SublimeLinter或ESLint等实时 lint 插件再试
真正难调的从来不是参数，而是主题文件里那些藏在 minimap.foldMarkscope 或 minimap_control rule 里的 foreground/color 值——它们不暴露给用户设置，只能手动补或换主题。
