document map 默认不显示是因为需手动启用且对ui缩放、行高敏感；需确认show_minimap为true、minimap_width未设为0、主题未隐藏该区域。
Document Map 为什么默认不显示？
sublime Text 的 Document Map（文档地图）不是靠“大纲视图”开关控制的，它压根不依赖代码结构解析，而是纯视觉缩略图滚动条——所以即使你装了 CTags 或 Outline 插件，Document Map 也不会自动出现。它需要手动启用且对 UI 缩放、行高敏感。
- 检查是否开启了
show_minimap：必须为true（默认是 true，但某些主题或配置可能关掉） - 确认
minimap_width没被设成 0 或极小值（比如"minimap_width": 1在高 DPI 下可能渲染失败） - 部分 UI 主题（如
Adaptive）会隐藏 minimap 区域，换回default主题可快速验证
如何让 Document Map 显示在右侧而不是底部？
Document Map 就是 minimap，它永远固定在编辑区右侧（除非你用插件强行挪位置），所谓“底部显示”其实是误把 status_bar 或 side_bar 当成了它。真正能调的只有宽度、透明度和是否点击跳转。
- 修改用户设置：
Preferences → Settings – User，添加： -
"minimap_width": 120（建议 80–150，太窄看不清，太宽挤占编辑区） -
"minimap_alpha": 0.9（默认 1.0，调低一点更柔和，避免抢眼） -
"minimap_show_buttons": true（开启后右下角有缩放按钮，方便临时聚焦某段）
Document Map 不随文件内容更新？
这通常不是 bug，而是 Sublime 延迟渲染策略生效了：大文件（>10MB 或 >10 万行）会禁用 minimap 以保响应速度。它不会报错，只是静默关闭。
- 检查控制台（
Ctrl+`）有没有输出Minimap disabled for large file - 临时启用：在命令面板（
Ctrl+Shift+P）运行Toggle Minimap，看是否闪现后消失 - 真要强开，加配置
"minimap_auto_resize": false+"minimap_max_file_size": 20971520（20MB），但卡顿风险自担
为什么 Python/js 文件里看不到函数折叠标记？
Document Map 和代码折叠（fold）完全无关。你在 minimap 上看到的是文本像素快照，不是符号树。想看函数/类大纲，得用 Ctrl+R（goto symbol）或安装 SideBarEnhancements 类插件。
- Document Map 永远不识别语法结构，只画文字灰度图
- 所谓“大纲视图”是误传，Sublime 官方没这个功能；第三方插件如
CTags或SymbolSync提供的才是真大纲 - 如果希望右侧同时有缩略图+大纲，只能分屏：左侧编辑，右侧用
View → Layout → Columns: 2放一个空标签页，再用插件生成大纲文本
Document Map 的本质就是个带交互的截图滚动条，别指望它理解代码。最容易被忽略的是：它不参与任何语言服务，也不受 sublime-project 配置影响，所有开关都在全局用户设置里。