sublime text 4 v4.4158+ 原生 minimap 需同时设置 "minimap_enabled": true 和 "show_minimap": true 才生效，旧插件、主题冲突或空标签页会导致失效，不支持 minimap_width 等字段。
Sublime 的 Minimap 不是“开启就能用”的功能，它默认关闭，且配置项名称、生效逻辑和常见失效原因高度混乱——直接照网上教程加 show_minimap 或 minimap_enabled 很可能无效，因为不同版本认的键名不一样，还常被插件或主题覆盖。
确认你用的是 Sublime Text 4 v4.4158+ 原生 Minimap
老版本（尤其是 ST3）或装过第三方 Minimap 插件的用户，Preferences.sublime-settings 里写 show_minimap 或 minimap_enabled 都不会生效——那是插件自己的字段，和原生功能冲突。原生 Minimap 从 ST4 开始内置，v4.4158+ 才修复 macOS 高 DPI 渲染错位问题。
- 检查版本：菜单栏
Sublime Text → About Sublime Text，必须显示Build 4158或更高 - 卸载旧插件：打开命令面板
Ctrl+Shift+P→Package Control: Remove Package→ 搜索并删掉名为Minimap的插件（不是CodeMap或CTags） - 重置主题：临时切到
Preferences → Color Scheme → Adaptive，排除主题覆盖渲染层
正确启用 Minimap 的唯一可靠方式
原生 Minimap 只响应两个开关：快捷键触发（即时生效），或用户设置中写对字段名。但这两个字段在不同子版本中兼容性不同，最稳写法是同时声明：
- 按
Ctrl+,（Windows/Linux）或Cmd+,（macOS）打开Preferences.sublime-settings - 在右侧用户设置 JSON 中添加这两行（注意逗号位置，保持合法 JSON）：
"minimap_enabled": true,<br>"show_minimap": true
- 保存后立刻生效；如果没出现，说明当前视图无文件内容（比如空标签页、剪贴板编辑状态），需先保存为真实文件（哪怕
temp.py）
为什么调了 minimap_width 没反应？
Sublime 原生 Minimap **不支持** minimap_width、minimap_alpha、minimap_side 这类字段——它们是旧插件或 VS Code 的配置项，写进设置里会被完全忽略，也不报错。所谓“宽度调整”，实际只有两种可行路径：
- 改字体大小：
"font_size": 12让代码行更紧凑，Minimap 内容自然更密集（视觉上“变宽”） - 改主题文件：进入
Preferences → Browse Packages→ 找到当前主题目录（如Material Theme）→ 编辑其.sublime-theme文件，在minimap_controlrule 里加"content_alignment": "left"实现左置（右置是默认，无需设） - 禁用干扰项：
"overlay_scrollbar": "disabled"可释放右侧最后一点横向空间，避免滚动条盖住 Minimap 边缘
Minimap 显示异常？先关插件，再查主题
灰色块、文字重叠、整条消失，90% 是渲染层冲突，不是配置错误。BracketHighlighter v2.26 及更早版本会强制隐藏 Minimap；Origami 分屏插件在多列布局下可能遮挡右侧区域。
- 临时禁用全部插件：
Preferences → Package Control → Disable Package，逐个试，重点盯BracketHighlighter、Origami、Theme - Material - 检查主题是否覆盖了
minimap.background：打开当前.tmTheme文件（路径见Preferences → Color Scheme），搜索minimap，补上缺失的 background 定义，值建议与编辑区gutter一致 - 大文件卡顿别关 Minimap，关自动居中：
"minimap_scroll_to_cursor": false能明显降低重绘压力
真正麻烦的从来不是“怎么开”，而是开了之后发现它被某个没留意的插件悄悄关掉，或者主题更新后覆盖了你的设置。每次莫名其妙消失，优先检查 BracketHighlighter 版本和当前是否处于未保存的空标签页——这两个点最容易被忽略。
