sublime text 4(build 4126+)需手动启用"minimap_show_hover_on_hover": true才能开启小地图悬停放大镜,该功能非插件提供、不支持st3,且依赖"minimap": true及正确json语法。

Sublime Text 小地图悬停放大镜默认不启用,需手动开启
Sublime Text 的小地图(Minimap)本身支持悬停放大预览,但这个功能默认是关闭的。不是插件问题,也不是版本限制,而是配置项 minimap_show_hover_on_hover 必须显式设为 true 才能触发悬停放大镜。
- 该设置仅在 Sublime Text 4(Build 4126+)中可用;Sublime Text 3 不支持此功能
- 修改的是用户级配置,不影响全局或插件行为
- 放大镜只在鼠标悬停于小地图区域时出现,点击小地图不会触发
如何正确启用小地图悬停放大镜
打开 Preferences → Settings,在右侧用户配置面板中添加或修改以下行:
{
"minimap_show_hover_on_hover": true,
"minimap": true
}
注意:"minimap" 也必须为 true(默认通常已是),否则小地图本身不显示,自然无法悬停。
- 保存后无需重启,小地图会立即响应悬停动作
- 放大镜默认显示当前悬停位置对应代码块的高亮缩略图,尺寸和清晰度由小地图自身渲染决定
- 如果仍无反应,检查是否启用了第三方主题或 UI 插件(如 Theme - Spacegray),部分主题会覆盖或禁用原生小地图交互
为什么改了配置却没效果?常见干扰点
最常踩的坑不是配置写错,而是被其他设置或环境掩盖:
-
mini_map(拼写错误)或minimap_show_hover_on_hover写成minimap_hover等非标准键名——Sublime 会静默忽略 - 配置文件里存在语法错误(比如多了一个逗号、少了一个引号),导致整个 JSON 解析失败,所有自定义设置失效
- 使用了
View → Hide Minimap临时隐藏,该操作会覆盖配置,需重新启用 - 某些高 DPI 显示器或远程桌面环境下,悬停判定区域偏移,表现为“明明指到了却没放大”,可尝试调高
ui_scale或切换窗口缩放模式
放大镜行为与实际体验差异
它不是独立窗口,也不是可拖拽的浮动预览,而是紧贴小地图底部边缘弹出的半透明缩略图,且有明显延迟(约 200ms)。这意味着:
- 快速扫过小地图时看不到放大效果,需短暂停留
- 缩略图分辨率受限于小地图渲染尺寸,大幅拉宽编辑器窗口并不会提升预览清晰度
- 不支持鼠标滚轮缩放、点击跳转或复制文本——它纯属视觉辅助,不提供交互能力
- 如果同时开启了
minimap_scroll_to_hover,悬停时编辑区会自动滚动到对应位置,可能干扰放大镜观察节奏
真正起作用的就两行配置,但容易卡在拼写、语法、覆盖或显示环境上。确认 Sublime 版本够新,再逐项排查这四个点,基本就能看到那个小小的、带毛玻璃效果的放大框了。











