codemap 是第三方侧边栏树形大纲插件，非 sublime text 原生 minimap；需通过 package control 安装，依赖语法高亮与正则匹配，不支持嵌套作用域和 import 语句，已十年未更新，推荐改用 ctags、symbol list 或原生 ctrl+p+@。
CodeMap 插件不等于 Minimap，别装错功能
Sublime Text 的 Minimap 是原生功能（右侧灰条缩略图），而 CodeMap 是第三方插件（侧边栏树形函数/类大纲）。两者完全无关，装 CodeMap 不会启用或增强 Minimap，反之亦然。很多用户搜“代码微缩结构图”时误以为 CodeMap 能画出类似 VS Code 那种带语法高亮的缩略图——它不能，它只输出纯文本结构树。
安装 CodeMap 必须走 Package Control，手动放文件无效
CodeMap 依赖 Package Control 的加载机制和语法定义注入，直接把 .py 文件丢进 Packages/ 目录不会生效。正确流程如下：
- 确认已安装 Package Control：按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Install Package Control并回车完成安装 - 再次调出命令面板，输入
Install Package，等待列表加载完毕 - 输入
CodeMap，选择并安装（注意：不是Code Map、CodeMap2或其他变体） - 安装后无需重启，但需确保当前文件有语法高亮（如
.py、.js），否则结构树为空
CodeMap 启动后没反应？检查语言支持和正则匹配限制
CodeMap 基于正则提取函数/类名，不依赖 AST 解析，因此对语法结构敏感。常见失效场景：
- Python 文件中用
@decorator包裹函数，或函数定义跨多行（如参数换行），CodeMap通常无法识别 - JS/TS 中箭头函数、class 字段初始化、TypeScript 泛型写法，正则规则早已过时，大概率漏掉
- 文件未设置正确 syntax：右下角显示
Plain Text时，CodeMap不工作；必须手动设为Python、JavaScript等 - 快捷键
Ctrl+Alt+Shift+C（Win/Linux）或Cmd+Alt+Shift+C（macOS）仅触发面板，不自动弹出侧边栏；首次使用需手动拖拽侧边栏宽度才能看到树
比 CodeMap 更靠谱的替代方案有哪些
截至 2026 年，CodeMap 已近十年未更新，维护者 wbond 也已停止响应 issue。实际项目中更推荐以下组合：
-
CTags+Ctrl+R：生成tags文件后，Ctrl+R列出当前文件所有符号，轻量、准确、无 UI 干扰 -
Symbol List插件：比CodeMap更新更勤，支持更多语言，侧边栏结构可折叠，但需手动刷新 - 原生
Ctrl+P+@：输入@后过滤当前文件函数名，响应快、零配置、不依赖插件 - 如果真要“微缩结构图”，请用原生
Minimap："show_minimap": true开启，配合"minimap_width": 120和"minimap_scale_text": false提升密度
真正容易被忽略的点是：CodeMap 的结构树不支持跳转到方法内部作用域（比如类里的嵌套函数），也不识别 import/require 语句——它只认顶层定义。这点在调试大型模块时会突然卡住。
