VSCode小地图未显示的首要原因是editor.minimap.enabled被设为false；需检查用户/工作区设置是否覆盖、禁用冲突插件，并可通过settings.json配置scale、renderCharacters等参数精细控制。
VSCode 小地图（Minimap）没显示，90% 是 editor.minimap.enabled 被设成了 false，不是功能没了，是开关关了——原生功能，不依赖插件，也不需要重装。
为什么右侧没有 Minimap？先查这三个地方
它不报错、不提示，只安静消失。最常见原因就三个：
-
editor.minimap.enabled在用户或工作区设置里被手动设为false（尤其远程开发或轻量主题下默认关） - 项目根目录下的
.vscode/settings.json里写了同名配置，覆盖了全局设置（右下角若显示「工作区」标签，说明当前生效的是工作区配置） - 装了老版
code minimap或含 “minimap” 字样的插件，和原生 Minimap 渲染逻辑冲突，导致双图、点击失灵甚至完全不渲染
验证方式：按 Ctrl + ,（Win/Linux）或 Cmd + ,（macOS）打开设置，搜 minimap.enabled，确认已勾选；再按 Ctrl + Shift + X 打开扩展面板，禁用所有含 “minimap”“mini map”“code 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会让缩略图更放大，适合高分屏或视力吃力；设为1更紧凑，小屏笔记本更友好 -
renderCharacters: false关闭字符级着色，只保留代码块轮廓，视觉干扰小、滚动更轻量，大型文件下 CPU 占用明显降低 -
showSlider: "mouseover"是默认值，滑块仅悬停时出现；设为"always"适合触控屏或习惯常驻滑块的人
想点一下就跳到对应位置？别漏了 clickToMoveCursor
Minimap 不只是看，还能点哪跳哪。但这个功能默认关闭，需手动启用：
- 在
settings.json中加一行："editor.minimap.clickToMoveCursor": true - 点击后光标会瞬移到对应行首（注意：是像素近似定位，不是严格对齐行号）
- 该选项对大文件（>10k 行）影响极小，但若发现点击偏移明显，可检查是否启用了
renderCharacters: false—— 关闭字符渲染后定位精度略有下降，属正常行为
快捷键临时开关 Minimap，不用装插件
VSCode 原生支持命令 editor.action.toggleMinimap，绑定快捷键即可秒切：
- 按
Ctrl + Shift + P，输入Preferences: Open Keyboard Shortcuts - 搜索
toggle minimap，找到editor.action.toggleMinimap - 双击快捷键列，按下你想要的组合键（比如
Ctrl + Shift + M），回车保存 - 注意：某些系统里
Ctrl + Shift + M默认是切换终端，冲突时换一组更稳妥（如Ctrl + Alt + M）
真正容易被忽略的，是工作区配置覆盖和旧插件残留——很多人改了用户设置却没生效，就是因为 .vscode/settings.json 里藏着一句 "editor.minimap.enabled": false，或者扩展面板里还躺着一个三年前装的 code minimap 插件。
