Minimap 未显示的首要原因是 editor.minimap.enabled 被设为 false；它属 VSCode 原生功能，无需插件，可通过设置界面或 settings.json 启用，注意作用域覆盖与主题/插件干扰。
VSCode 默认开启 Minimap，如果右侧没看到缩略图，基本就是 editor.minimap.enabled 被设成了 false，而不是插件没装或功能缺失。
为什么 Minimap 没显示？先查这个配置
很多人以为要装插件、改主题、甚至重装 VSCode，其实根本不用。Minimap 是原生功能，开关就靠一个布尔值。
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开设置界面 - 搜索框输入
minimap.enabled - 确认
Editor > Minimap: Enabled已勾选；若未勾选，点一下立即生效 - 如果勾选后仍不出现，说明有更高优先级的配置覆盖了它——比如工作区
.vscode/settings.json里写了"editor.minimap.enabled": false，或者某个插件强制禁用
settings.json 里怎么写才真正生效
手动编辑配置文件最可控，但要注意作用域和覆盖顺序。
- 全局生效：在用户级
settings.json（命令面板输入Preferences: Open Settings (JSON)打开）中添加："editor.minimap.enabled": true - 仅当前项目生效：在项目根目录下
.vscode/settings.json中添加同一行 - 别写错键名：
editor.minimap.enable或minimap.enabled（缺editor.前缀）都不起作用 - 如果左右两个 JSON 编辑器窗口都打开了，右边那个是工作区设置，它的同名配置会覆盖左边的用户设置
开了还是看不见？检查插件和主题干扰
某些插件或主题会悄悄接管 Minimap 渲染逻辑，导致设置失效。
- 打开扩展面板（
Ctrl+Shift+X），搜索minimap、code minimap等关键词，禁用所有相关旧插件（尤其是已停更的） - 换回默认主题（如
Default Dark+）测试：如果换完就出现了，说明原主题（如 One Dark Pro、Nord）强制禁用了 Minimap 或重写了样式 - 打开开发者工具（
Ctrl+Shift+P→Developer: Toggle Developer Tools），在 Console 输入：monaco.editor.getConfiguration().minimap.enabled
返回true才算真启用；返回false就说明被某处硬覆盖了
想临时开关？用原生命令，别装插件
VSCode 自带 editor.action.toggleMinimap 命令，绑定快捷键比装第三方插件更稳。
- 打开命令面板（
Ctrl+Shift+P），输入Preferences: Open Keyboard Shortcuts (JSON) - 在
keybindings.json中加一段：
[
{
"key": "ctrl+alt+m",
"command": "editor.action.toggleMinimap"
}
]
- 保存后，按
Ctrl+Alt+M（或其他自定义组合）就能秒切，无需重启，也不依赖任何扩展 - 注意：这个命令只影响当前编辑器实例，新开一个文件时状态独立
真正卡住人的不是“怎么开”，而是开了之后发现颜色糊、结构不清、或者触控板双指滑动误触发——那得调 editor.minimap.renderCharacters 或 editor.minimap.scale，而不是反复折腾开关。
