minimap 默认开启，确认是否启用需查设置项 editor.minimap.enabled 的值是否为 true；关闭方式有两种：全局关闭在用户设置中设为 false，或仅当前项目关闭则写入工作区 .vscode/settings.json。
Minimap 默认是开启的，但很多用户根本没注意到它存在——不是它没开，是你没调宽、没看清、没点过。
怎么确认 Minimap 是否已启用
别猜，直接查设置项：editor.minimap.enabled。它的值是 true 就代表开着，false 就是关了。VSCode 启动时默认设为 true，但某些轻量主题或远程开发环境可能覆盖该值。你可以在设置搜索框里输 minimap.enabled，看开关是否被手动关掉；也可以打开 settings.json 检查有没有这行配置。
关闭 Minimap 的两种方式（别改错地方）
关 Minimap 很简单，但容易改错作用域：
- 想全局关闭：在用户设置（User Settings）中把
editor.minimap.enabled设为false，所有项目都生效 - 只想关当前项目：在工作区根目录的
.vscode/settings.json里加这一行："editor.minimap.enabled": false，不会影响其他文件夹 - 别去改
editor.minimap.side或renderCharacters来“假装关闭”——它们控制位置和渲染方式，不关显示本身
为什么开了却看不见？常见视觉陷阱
Minimap 开着但几乎不可见，通常不是 bug，而是以下几种情况：
- 宽度太窄：默认宽度约 10–12px，颜色块糊成一条线。建议手动拖右边缘拉宽到 20–30px，或在设置里搜
minimap size看有没有插件锁定了尺寸 - 主题太淡：深色主题下浅灰代码块在深背景里对比度低，换一个高对比主题（比如
Dark+ (default dark)）立刻明显 - 启用了
editor.minimap.autoHide：这个选项会让 Minimap 默认隐藏，只在鼠标悬停时浮现——看起来像没开，其实是“隐身模式” - 缩放异常：系统缩放为 125% 但 VSCode 用了非整数缩放因子，导致 Minimap 区域渲染模糊甚至“消失感”，此时要加启动参数
--force-device-scale-factor=1.25
点击 Minimap 没反应？检查这个关键开关
很多人开了 Minimap 却点不动，光标不跳转，问题大概率出在：editor.minimap.clickToMoveCursor 是 false。这个布尔值必须为 true 才支持点击跳转。它默认是 true，但如果用过某些定制配置或插件模板，可能被静默覆盖。直接在设置里搜 click to move cursor，勾选即可。不需要重启，改完立刻生效。
Minimap 最容易被忽略的复杂点不在开关逻辑，而在「视觉反馈是否可信」——它不报错、不弹窗、不警告，只默默变细、变淡、变隐形。调宽、换主题、确认 clickToMoveCursor，三步做完，它才真正开始帮你导航。
