必须使用universal-ctags并指定--output-format=e-ctags，因Sublime CTags插件仅兼容该格式；旧版exuberant-ctags输出不兼容，导致F12和Ctrl+Shift+R失效。
ctags 命令必须用 universal-ctags，旧版 exuberant ctags 会失效
Sublime 的 CTags 插件依赖 ctags 命令输出的符号格式，而系统自带或旧版 exuberant-ctags 默认输出的是不兼容的 exuberant 格式。插件读不到符号，F12 和 Ctrl+Shift+R 就全为空。
验证方式：终端执行 ctags --version，输出中必须含 universal-ctags 字样；若显示 Exuberant Ctags，就得重装：
- macOS：
brew uninstall ctags && brew install universal-ctags - Windows：从 universal-ctags GitHub releases 下载最新
ctags.exe，加进PATH - Linux（Ubuntu/Debian）：
sudo apt remove exuberant-ctags && sudo apt install universal-ctags
生成索引时务必显式指定 --output-format=e-ctags，否则即使装了 universal 版也可能回退到旧格式。
tags 文件必须放在项目根目录，且不能被 .gitignore 忽略（但建议手动忽略）
CTags 插件默认只在 Sublime 打开的项目根目录下查找 tags 文件，不会向上递归搜索父目录，也不会识别子目录里的 tags。放错位置 = 插件完全看不见索引。
正确做法：
- 用
cd /path/to/your/project进入项目最外层文件夹（即Project → Add Folder to Project选的那个目录） - 运行：
ctags -R --output-format=e-ctags --fields=+niaz --python-kinds=+i --c++-kinds=+p -f tags . - 确认当前目录下生成了名为
tags的文件（不是.tags或tags.sorted）
注意：tags 文件本身可被 .gitignore 排除，但插件加载它不依赖 Git 状态 —— 忽略是为了避免提交二进制索引，不是功能必需。
CTags 插件跳转失败，90% 是索引未生效，不是快捷键没按对
常见现象：按 F12 没反应、Ctrl+Shift+R 列表空、右键 Go to Definition 跳到错误行。这不是快捷键冲突或插件坏了，而是索引根本没加载成功。
排查顺序：
- 检查 Sublime 右下角状态栏是否显示
Indexing…—— 若还在跑，等它消失再试 - 打开命令面板
Ctrl+Shift+P，输入CTags: Rebuild Tags并执行，看是否报错（如command not found: ctags） - 确认插件 settings-user 中没有误写
"command": "/wrong/path/ctags"—— 默认留空即可，插件会自动找PATH中的ctags - Python 项目里装饰器函数（如
@lru_cache）、lambda、嵌套函数不会被索引 —— 这是ctags本身的限制，不是配置问题
真正起效的跳转组合是：Ctrl+Alt+Click（跨文件跳定义）或 Ctrl+Shift+R（模糊搜整个项目符号），F12 只是快捷入口，底层仍走同一索引。
Python 项目需额外加 --python-kinds=+i，否则 def/class 不进列表
universal-ctags 对 Python 默认只索引变量和导入项，def 和 class 关键字需要显式启用。不加这个参数，Ctrl+Shift+R 里就只能看到变量名，函数名全消失。
完整推荐命令（含常用排除）：
ctags -R \ --output-format=e-ctags \ --fields=+niaz \ --python-kinds=+i \ --c++-kinds=+p \ --exclude=.git \ --exclude=__pycache__ \ --exclude=node_modules \ --exclude=venv \ -f tags .
其中 +i 表示开启 Python 的 def（i = function）和 class（i 也覆盖 class）；+p 对 C++ 启用函数原型索引。其他语言同理查 ctags --list-kinds=python 获取支持类型。
动态特性（如 getattr(obj, func_name)）永远无法被 ctags 解析 —— 它只做静态文本扫描，这点比不过 LSP，但胜在快、无依赖。
