缩略图默认开启但可能因配置关闭、主题过淡或宽度太窄而不可见；需检查editor.minimap.enabled是否为true、设editor.minimap.width为"60px"、启用editor.minimap.clicktomovecursor并选用高对比主题。
缩略图（minimap）默认就开着，看不见基本是因为配置被关了、主题太淡、或宽度被压到几乎不可见——不是功能缺失，是视觉反馈没调对。
确认 editor.minimap.enabled 是否为 true
VSCode 启动时默认设 editor.minimap.enabled 为 true，但很多用户手动关过，或被工作区配置覆盖。直接查最准：
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置界面 - 搜索框输入
minimap.enabled - 检查开关是否勾选；若未勾选，点一下立即生效
- 若勾选后仍不显示，打开命令面板
Ctrl+Shift+P→ 执行Preferences: Open Settings (JSON)，删掉或注释掉所有editor.minimap.enabled相关行（包括false值），让 VSCode 回退到内置默认
调宽缩略图到可读范围：用 editor.minimap.width
默认宽度约 10–12px，在高分辨率屏上几乎是一条灰线，根本看不出结构。它不靠拖拽调整，必须写配置：
- 在
settings.json中添加："editor.minimap.width": "60px"（推荐值，兼顾清晰度与空间） - 支持单位：
"20%"、"50px"、"80"（无单位时按像素解析） - 别写成
60（无引号）——JSON 会报错；也别写"60"（无单位），语义模糊且易被误读 - 设为
"0"或false会禁用缩略图，不是“隐藏” - 该设置仅在
editor.minimap.enabled为true时生效
点击缩略图跳转光标失效？检查 clickToMoveCursor
开了缩略图却点不动，大概率是 editor.minimap.clickToMoveCursor 被设为 false。这个开关控制点击行为，和显隐无关：
- 默认为
true，但某些插件模板或定制配置会静默覆盖 - 在设置界面搜
click to move cursor，勾选即可，无需重启 - 如果用 JSON 配置，加一行：
"editor.minimap.clickToMoveCursor": true - 注意：它只影响点击跳转，不影响鼠标悬停高亮或拖动滚动
为什么缩略图看起来模糊或错位？盯住 DPI 和渲染模式
缩略图没有独立缩放，它的清晰度完全依赖系统 DPI、window.zoomLevel 和字体大小的叠加效果：
- 当
editor.fontSize过大（如20），缩略图相对变窄，颜色块挤压失真 - 高 DPI 屏幕 + 非整数
window.zoomLevel（如1.25）会导致 bitmap 缩放锯齿；可启动时加参数--force-device-scale-factor=1.25 - 设
"editor.minimap.renderCharacters": false改用色块渲染，更紧凑但丢失语法细节（比如括号配对、字符串/注释区分） - 主题对比度低（如浅灰代码块配深灰背景）会让缩略图“隐形”，换 Dark+ 主题立刻可见
真正容易被忽略的复杂点，是缩略图从不报错也不提示——它只是悄悄变细、变淡、变不响应。调宽、确认 clickToMoveCursor、换高对比主题，三步做完，它才真正开始帮你导航。
