关闭 minimap 的唯一有效方式是将 editor.minimap.enabled 设为 false,且需触发 zen mode(ctrl+k z)再退出才能生效;通过菜单关闭仅为临时切换,快捷键可绑定 editor.action.toggleminimap 命令。

关闭 MiniMap 的两种可靠方式
VS Code 的 MiniMap(代码缩略图)默认开启,它在编辑器右侧显示代码结构概览,但对多数专注编码的场景是视觉干扰。关闭它不依赖插件,而是原生设置项,且生效逻辑有隐藏细节。
-
editor.minimap.enabled设为false是唯一有效配置,其他名称如minimap或showMinimap均无效 - 修改后无需重启 VS Code,但必须手动触发一次 Zen Mode(
Ctrl+K Z)再退出,新设置才会应用到常规视图——这是官方未明示的行为,不是 Bug - 如果通过菜单关闭(
View → Show Minimap),只是临时切换,下次打开文件或重启后会恢复原状
为什么改了 settings.json 还没消失?
常见现象是:在 settings.json 里加了 "editor.minimap.enabled": false,保存后缩略图依然存在。根本原因不是配置写错,而是 VS Code 的 UI 状态缓存机制:
- 编辑器窗口在启动时会读取设置,但已打开的编辑器实例不会动态重载该配置
- 只有触发 Zen Mode(全屏禅模式)并退出,才会强制刷新整个 UI 层,包括 MiniMap 的渲染开关
- 若你启用了
zenMode.restore,退出 Zen Mode 后侧边栏、状态栏等也会恢复;否则它们可能一并消失,容易误判为配置失效
想用快捷键快速开关 MiniMap?
VS Code 原生不提供 MiniMap 开关快捷键,但可通过命令面板绑定:
- 按
Ctrl+Shift+P打开命令面板,输入Preferences: Open Settings (JSON) - 在
settings.json中添加快捷键映射(注意是keybindings.json):
[
{
"key": "shift+m",
"command": "editor.action.toggleMinimap",
"when": "editorTextFocus"
}
]
toggleMinimap 是唯一可用命令名,拼错如 toggleMiniMap 或 toggleMinimapView 会静默失败进阶精简:连带隐藏其他干扰元素
单纯关 MiniMap 只解决右侧干扰,若追求极简编辑视图,建议同步调整以下几项:
-
editor.lineNumbers设为"off":去掉左侧行号(注意值是字符串"off",不是布尔false) -
editor.renderWhitespace设为"none":隐藏空格/制表符标记 -
workbench.activityBar.visible设为false:隐藏左侧活动栏(图标栏) - 以上设置均需配合 Zen Mode 触发刷新才可见效,尤其
activityBar类 UI 元素
settings.json 就立刻生效——它确实改对了,但 VS Code 不主动重绘 UI,得靠 Zen Mode 当“扳机”来拉起一次完整刷新。这点在文档里几乎找不到,却是真实工作流里的关键一环。











