VSCode Minimap 是原生功能而非插件，未显示通常因 editor.minimap.enabled 为 false、工作区配置覆盖或旧版 minimap 插件冲突；需检查设置、禁用冲突插件并刷新；关键配置包括 clickToMoveCursor、scale、renderCharacters 等。
VSCode 的 Minimap 不是插件功能，而是原生内置的；只要 editor.minimap.enabled 是 true，它就该出现——没看到，基本不是“没装”，而是被关了、被覆盖了，或者视觉上糊成一条线。
为什么 Minimap 开着却看不见？先查这三项
它不报错、不提示，只默默隐身。常见原因有三个：
-
editor.minimap.enabled被设为false（最常见，尤其在远程开发或某些轻量主题下） - 工作区
.vscode/settings.json里写了同名配置，覆盖了用户设置（右下角设置图标旁若亮着「工作区」标签，就说明当前生效的是工作区配置） - 装了老版本 minimap 插件（如
code minimap或含mini map的扩展），和原生 Minimap 渲染冲突，导致双图、点击失灵甚至完全不渲染
验证方式：按 Ctrl + ,（Windows/Linux）或 Cmd + ,（macOS）打开设置，搜 minimap.enabled，确认开关已勾选；再打开扩展面板（Ctrl + Shift + X），禁用所有含 “minimap” 字样的插件，然后按 Ctrl + R 刷新窗口。
如何用 settings.json 一次性配齐常用样式
图形界面能开/关，但微调必须靠 JSON 配置。打开命令面板（Ctrl + Shift + P），输入并选择 Preferences: Open Settings (JSON)，在花括号内添加以下几行（注意逗号分隔）：
"editor.minimap.enabled": true, "editor.minimap.side": "right", "editor.minimap.scale": 1, "editor.minimap.renderCharacters": false, "editor.minimap.showSlider": "mouseover"
说明：
-
scale设为2更适合高分屏或视力吃力；设为0.8可压缩宽度，减少干扰 -
renderCharacters: false关闭字符级渲染，只显示区块轮廓，滚动更轻量，CPU 占用更低（尤其 >10k 行文件） -
showSlider: "always"适合触控屏或习惯常驻滑块的人；"mouseover"是默认值，悬停才出滑块
Minimap 点击跳转不生效？检查这个布尔值
很多人开了 Minimap 却点不动，光标不跳转，问题几乎一定出在：editor.minimap.clickToMoveCursor 是 false。它控制点击定位能力，默认是 true，但某些定制模板或插件会静默覆盖。
解决方法很简单：在 settings.json 中加一行：
"editor.minimap.clickToMoveCursor": true
改完立刻生效，不用重启。注意：点击是像素近似定位，不是严格对齐行号——所以跳转位置可能略偏一两行，这是设计行为，不是 bug。
容易被忽略的复杂点：视觉反馈不可信
Minimap 没有错误日志，也不弹警告，但它对主题对比度、系统缩放、插件注入 CSS 极其敏感。比如深色主题下浅灰代码块在深背景里几乎隐形；系统缩放为 125% 但 VSCode 用了非整数缩放因子时，Minimap 区域可能模糊到“看起来像没开”。这时候拉宽右侧边缘、换回 Dark+ 主题、或加启动参数 --force-device-scale-factor=1.25，比反复重装插件管用得多。
