直接将用户级 settings.json 中的 "editor.minimap.enabled": false 即可全局关闭 Minimap,无需重启或安装插件;若仍显示,需检查工作区设置、主题/插件覆盖及远程开发配置,并用开发者工具验证返回值是否为 false。

直接设 editor.minimap.enabled 为 false 就行,改完立刻生效,不重启、不装插件。
怎么在用户级 settings.json 里关掉 Minimap
全局设置 = 所有工作区都生效的配置,写在用户级 settings.json 中:
- 按
Ctrl+,(Windows/Linux)或Cmd+,(macOS)打开设置界面 - 右上角点 “打开设置(JSON)” 图标(花括号 {}),或用命令面板运行
Preferences: Open Settings (JSON) - 在左侧面板(用户设置)中添加这一行:
"editor.minimap.enabled": false - 保存文件,Minimap 立即消失 —— 不需要重载窗口
为什么设了 false 还在?优先查这三处覆盖
不是配置没写对,而是被更高优先级设置或插件盖掉了:
- 检查右侧面板(工作区设置)的
.vscode/settings.json是否写了"editor.minimap.enabled": true—— 工作区级永远压过用户级 - 设置界面搜
minimap,看Editor > Minimap: Enabled右侧有没有锁图标??有说明被主题(如 One Dark Pro)或插件(如旧版 Bracket Pair Colorizer)强制启用 - 远程开发(SSH / Codespaces)下,你本地改的是本地配置,但 Minimap 渲染由远端服务控制;必须在远程窗口里重新开一次设置并关闭
验证是否真关成功,别信 UI 直觉
右下角齿轮图标旁若显示「工作区」标签,说明当前 UI 显示的是工作区设置 —— 它可能和你刚改的用户设置完全无关。
最可靠验证方式:
- 按
Ctrl+Shift+P→ 输入Developer: Toggle Developer Tools打开开发者工具 - 切到 Console 标签页,输入:
monaco.editor.getConfiguration().minimap.enabled - 返回
false才算真正落地;返回true就说明某处还在偷偷启用它
真正容易被忽略的点:很多人在用户设置里关了,却忘了项目根目录下有个 .vscode/settings.json,里面一行 "editor.minimap.enabled": true 就足以让所有努力白费。关之前,先看一眼那个文件是否存在、内容是什么。


















