直接关闭 editor.minimap.enabled 即可即时禁用缩略图,无需重启或插件;但大文件(如>500行json/日志)中定位效率会下降,建议先单文件试用10分钟再决定是否全局关闭。

直接关掉 editor.minimap.enabled 就行,不用重启、不依赖插件,改完立刻生效。 但关之前得确认你真不需要它——尤其处理 >500 行的 JSON、日志或模板文件时,失去缩略图后定位效率会明显下降。
怎么关:三种入口,本质都是改同一个配置项
所有方式最终都写入 editor.minimap.enabled 这个布尔值,设为 false 即可:
- 快捷键
Ctrl + ,(Windows/Linux)或Cmd + ,(macOS),搜索minimap.enabled,取消勾选 - 左下角齿轮图标 ⚙️ → Settings → 搜索
minimap→ 找到Editor: Minimap Enabled→ 关闭 - 手动编辑
settings.json,添加一行:"editor.minimap.enabled": false(注意逗号结尾是否合规,别破坏 JSON 结构)
为什么关了还显示?常见覆盖源优先级比 UI 设置高
设置界面关掉却没反应,基本不是操作失误,而是更高优先级的配置在“顶着”:
-
settings.json里写了"editor.minimap.enabled": true,会盖过 UI 设置;检查全局和工作区两个settings.json - 某些主题(如
One Dark Pro、Nord)会强制启用 Minimap 来适配滚动条样式;换回默认主题Default Dark+可快速验证 - 旧扩展如
Minimap Hide已停更,可能劫持渲染逻辑;禁用所有非必要扩展再试 - 远程开发(SSH / Dev Container)时,本地和远程两端设置分离;确认你改的是当前连接环境的设置
关掉之后,哪些功能会变弱?
Minimap 不参与代码逻辑,关了不影响运行、跳转、搜索,但它确实承担一部分导航职责:
- 大文件中靠拖拽缩略图快速定位某段代码,关掉后只能依赖
Ctrl + G行号、大纲视图(Ctrl + Shift + O)或全文搜索(Ctrl + F) -
Alt + Click在 Minimap 上点击可直接跳转到对应位置,这个快捷方式失效 - Mac 用户若只嫌它占宽,可考虑设
"editor.minimap.showSlider": "always",保留滑块(约 2px 宽),比全关更平衡 - 真正卡住人的往往不是“怎么关”,而是关完在某个 2000 行的配置文件里来回找字段时,突然发现没缩略图太难扫结构——建议先单文件试 10 分钟再决定是否全局关
最常被忽略的一点:Minimap 的渲染压力在远程开发或低配机器上不可小觑。如果编辑器偶尔卡顿,优先试试关掉 editor.minimap.renderCharacters 或直接禁用 editor.minimap.enabled,比调内存参数见效更快。











