sublime text 4 内置 minimap,无需安装插件;只需在用户设置中添加 "show_minimap": true 即可启用,其他如 codeminimap 等均为误导,旧插件还可能导致冲突。

Sublime Text 没有叫 CodeMinimap 的插件,也无需安装
直接告诉你结论:你搜到的“安装 CodeMinimap 插件”全是误导。Sublime Text 4(当前主流版本)内置了 Minimap 功能,不是插件,不需下载、不需 Package Control 安装——它默认关闭,只差一行配置就能启用。
常见错误现象:
• 在 Package Control 里搜 CodeMinimap 或 Minimap,结果为空或返回过时/失效包
• 按网上教程下载 ZIP、解压到 Packages 目录,重启后仍不显示,甚至引发渲染异常
• 错把 IntelliJ 的 CodeGlance 名字套用到 Sublime 上
真正该做的只有三步:
• 按 Ctrl + ,(Windows/Linux)或 Cmd + ,(macOS)打开 Preferences.sublime-settings
• 在右侧「User Settings」JSON 中添加:"show_minimap": true
• 保存,立刻生效(不用重启,也不用新建文件)
为什么加了 show_minimap 还没出现?检查这几点
配置写了但右侧没缩略图,大概率是以下原因:
- 改错了面板:务必确保修改的是右侧「User Settings」,左侧
Default是只读的,写进去也没用 - 键名拼错:
"minimap_enabled": true、"enable_minimap": true、"minimap": true全都不认——Sublime 只响应show_minimap - 当前视图无内容:空标签页、剪贴板临时编辑状态、未保存的
Plain text文件,Minimap 不会渲染 - 被插件屏蔽:旧版
BracketHighlighter(v2.26 及之前)会强制隐藏 Minimap;Origami等分屏插件可能占用右侧渲染层
验证是否真生效:按 Ctrl + ` 打开控制台,输入 sublime.active_window().active_view().settings().get('show_minimap'),返回 True 才算成功。
Minimap 的宽度、透明度怎么调?别信 GUI,全靠手写
Sublime 原生 Minimap **不支持** minimap_width、minimap_alpha、minimap_side 这类字段——它们来自旧插件或 VS Code,写进设置会被静默忽略,也不报错。
能调的参数只有这些(加到 Preferences.sublime-settings):
• "minimap_width": 120:仅在 ST4 v4.4158+ 之后有效,建议值 100–150,超宽会挤占编辑区
• "minimap_alpha": 0.8:透明度范围 0.0–1.0,设太低(如 0.3)会导致悬停定位困难
• "minimap_draw_single_layer": false:设为 true 可略微提升大文件滚动性能,但丢失语法高亮色块细节
• "minimap_scroll_to_cursor": false:关掉自动居中,减少重绘,缓解卡顿
注意:
• 所有参数必须是合法 JSON 格式,布尔值不加引号,数字不加引号
• 修改后保存即实时生效,无需重启
• 若调了 minimap_width 没反应,说明你用的是低于 v4.4158 的 ST4 版本,或仍残留旧 Minimap 插件
想固定左侧函数列表?Symbol List 插件才是正解
Minimap 是右侧代码缩略图,不是左侧大纲。如果你要的是类似 VS Code Outline 面板的左侧函数树,得用 Symbol List 插件——它不依赖外部工具,纯 Python 实现,识别精度取决于当前语言的语法定义。
关键配置只有这一行必须加:
• 打开 Preferences → Package Settings → Symbol List → Settings
• 确保有:"show_in_sidebar": true(缺了这句,它只会弹窗一次就消失)
其他实用项:
• "sidebar_width": 280:建议 240–300,太小截断函数名,太大抢编辑空间
• "sort_order": "file_then_symbol":按文件再按符号排序,更易定位
• 如果函数不显示,先右下角点开语法类型,确认不是 Plain text;再检查语言包是否定义了 meta.function scope
最后提醒一句:Minimap 和 Symbol List 解决的是两类问题——前者帮你快速滚动定位,后者帮你结构化跳转。别指望一个配置同时搞定侧边缩略图和左侧函数树,它们底层机制完全不同。











