sublime text小地图配置必须使用正确参数名（如minimap_scale_text）且写在用户设置中，show_minimap需为布尔值true，配合font_size≥12、gpu加速及兼容主题才能正常显示和交互。
为什么改了minimap_scale完全没反应
这个键名是无效的，Sublime Text 解析配置时会直接忽略，不报错也不生效。网上大量教程复制粘贴错误配置，导致你反复试错却看不到变化。真正起作用的参数只有几个：show_minimap、minimap_width、minimap_scale_text（注意拼写和大小写），且它们各自作用边界非常明确——别指望靠一个参数解决所有问题。
show_minimap设为true后仍不显示？先验证三件事
不是菜单点错了，也不是插件没装，而是配置根本没被识别或被覆盖：
-
show_minimap必须写在用户设置（User Settings）里，不是 Default；左侧 Default 是只读的，改了也白改 - 值必须是布尔型
true，不能写成字符串"true"或其他变体（如minimap_enabled、enable_minimap全部无效） - 按
Ctrl + `打开控制台，输入sublime.active_window().active_view().settings().get('show_minimap')，返回True才算真正生效 - 如果返回
None，说明压根没声明，不是“关了”，是“没配”
小地图发灰/糊成一条线？关键不在minimap_width
minimap_width 只控制容器宽度（单位 px），不影响内部清晰度。设成 150 后你只是看到更多行的轮廓，但每行依然模糊——除非同步提升 font_size 到 ≥12。高 DPI 屏幕下尤其明显：
-
font_size必须 ≥12：设为 8 或 9，小地图基本就是一条灰带 - 启用 GPU 加速：
hardware_acceleration设为"opengl"（Windows/Linux）或"metal"（macOS） - 主题必须支持 minimap 渲染：Adaptive、Default 可靠；Material Theme、Ayu 等常把
minimap.background设为透明，切回默认主题验证 - Windows 用户需右键快捷方式 → 属性 → 兼容性 → “更改高 DPI 设置” → 勾选“替代高 DPI 缩放行为”，选“应用程序”
拖拽卡顿、点击跳转失效？别调显卡驱动，先查这两个开关
Minimap 的交互卡顿几乎从不源于硬件性能，而是配置冲突：
-
minimap_scroll_to_click必须为true（允许点击跳转） -
minimap_scroll_to_cursor必须为false（否则光标移动会强制居中，和手动拖拽抢滚动管线） - 关掉干扰项：
overlay_scrollbar设为"disabled"，避免滚动条盖住 Minimap 边缘；minimap_draw_single_layer设为true可大幅提升大文件拖动流畅度（代价是语法色变灰） - 某些插件（如 Origami、BracketHighlighter）会在 Minimap 区域叠加图层，临时禁用排查
font_size、GPU 渲染、主题背景色、容器宽度四者协同的视觉结果，缺一不可。
