sublime text 4 仅识别 minimap_enabled 布尔配置项,设为 false 才真正禁用 minimap;其他键名如 show_minimap 等完全不读取,且需确保修改 user settings、值为布尔 false、拼写正确、保存后重启或执行 toggle_minimap。

为什么改了配置 Minimap 还在?只认 minimap_enabled,其他字段全失效
Sublime Text 4 实际只响应 minimap_enabled 这一个布尔配置项,设为 false 才真正卸载渲染逻辑;show_minimap、draw_minimap、minimap 等写法在 2025 年后已完全被忽略——不是“不推荐”,是压根不读取。你加了也不会报错,但控制台查 sublime.active_window().active_view().settings().get('minimap_enabled') 仍返回 True,说明配置没生效。
必须确保:
• 改的是右侧 Preferences.sublime-settings(User Settings),不是左侧 Default
• 值是纯布尔型 false,不是字符串 "false"
• 键名拼写完整:minimap_enabled(带下划线,双 m)
• 保存文件后,新窗口立即生效;已有窗口需手动执行一次 toggle_minimap 命令或重启
关掉 minimap_enabled 后右侧还有细缝?大概率是 overlay_scrollbar 在占位
Minimap 隐藏后右侧残留 2–4 像素竖缝,不是配置没生效,而是滚动条仍在预留空间。尤其在 macOS 或高 DPI Windows(如 150% 缩放)下,overlay_scrollbar 默认启用,它虽“透明”,但固定占宽。
验证方式:打开控制台(Ctrl+`),输入:sublime.active_window().active_view().settings().get('overlay_scrollbar')
若返回 true,就在用户设置中追加:"overlay_scrollbar": "disabled"
注意值用字符串 "disabled",不是布尔 false——这是 Sublime 的硬编码约定。
想临时开关 Minimap?别点菜单,用快捷键 Alt+M(Win/Linux)或 Option+M(macOS)
菜单里的 View → Hide Minimap 只是视觉隐藏,不释放布局空间,且仅作用于当前视图状态;而快捷键 Alt+M 直接触发底层 toggle 逻辑,效果等同修改 minimap_enabled,新开窗口也继承该状态(前提是没设永久配置)。
如果快捷键无效:
• 先确认编辑区有焦点(点一下代码区)
• 检查是否启用了无菜单栏模式:Ctrl+Shift+P → 输入 Toggle Menu 回车恢复
• 插件冲突极少见,但可临时禁用插件验证
需要按语言类型开关 Minimap?用 Settings – Syntax Specific,不是改通用配置
比如 Markdown 笔记不需要缩略图,但 Python 脚本需要快速定位长函数——这时不能全局关 minimap_enabled,得走语法专属设置。
操作步骤:
• 打开一个 .md 文件
• Preferences → Settings – Syntax Specific
• 在右侧添加:{"minimap_enabled": false}
• 保存后,该语法(Markdown)下 Minimap 永久关闭,其他语言不受影响
注意:这个文件叫 Markdown.sublime-settings,和通用 Preferences.sublime-settings 是两个独立配置
真正干净的“极致简约”不是只关 Minimap,而是同步处理侧边栏(Ctrl+K, Ctrl+B)、状态栏("show_status_bar": false)和滚动条行为;否则那几像素空白,只是从右边挪到了底部。











