sublime text原生不支持跨文件函数跳转，必须依赖universal-ctags生成e-ctags格式的tags文件并配合ctags插件实现；tags需置于项目根目录、命名全小写无后缀、为lf换行，且插件设置中须指定正确ctags路径并重启生效。
Sublime Text 原生不支持跨文件函数跳转，F12 或 Ctrl+Click 在大型项目里基本失效——这不是配置问题，是它根本没这个能力；必须靠 universal-ctags 生成静态索引 + CTags 插件读取，才能实现可靠跳转。
为什么 universal-ctags 是硬性要求
旧版 exuberant-ctags 输出格式不兼容，Sublime 的 CTags 插件直接读不到符号；macOS 自带的 BSD ctags、Ubuntu 默认包管理器装的版本，对 Python 装饰器、C++ 模板、Go 泛型等一概漏索引。
- 验证方式：终端运行
ctags --version，输出必须含Universal Ctags字样 - macOS：用
brew install universal-ctags，别信brew install ctags - Windows：去 GitHub Releases 下载最新
ctags.exe，放C:\tools\ctags这类干净路径，加进系统 PATH - Linux（Ubuntu/Debian）：先
sudo apt remove exuberant-ctags，再sudo apt install universal-ctags
tags 文件必须满足三个硬条件
插件只在项目根目录找名为 tags（全小写、无后缀）的文件，且必须是 Unix 换行（LF）、e-ctags 格式；放错位置或格式不对，就等于没建索引。
- 生成命令必须显式指定：
ctags -R --output-format=e-ctags --fields=+niaz --c++-kinds=+p -f tags . - 别用
-o或--output-file，插件不认路径自定义 - 生成后用
file tags检查换行：若显示CRLF，立刻dos2unix tags - 确保 Sublime 是通过
Project → Add Folder to Project打开整个仓库根目录，不是子文件夹
CTags 插件设置里最常踩的坑
插件默认不自动重建、不监听变更、不读系统 PATH；"command" 写错或留空，会导致右键菜单里 CTags: Rebuild Tags 静默失败，控制台也不报错。
- 打开
Preferences → Package Settings → CTags → Settings – User - 写死绝对路径：
"command": "C:/tools/ctags/ctags.exe"（Windows）或"command": "/opt/homebrew/bin/ctags"（macOS） - 删掉
"auto_generate_tags": true—— 大型项目下它会卡死 UI，手动触发更稳 - 确认
"enabled": true，ST4 用户必须用 CTags v3.0+，旧版静默失效 - 重启 Sublime（不是关文件），否则插件仍用旧缓存
跳转失效时优先排查这三件事
90% 的“跳不到”问题，根源不是快捷键按错，而是索引压根没加载成功。别急着重装插件，先看底层状态。
- 右下角状态栏是否显示
Indexing…？等它消失再试 - 打开控制台（
Ctrl+`），输sublime.log_commands(True)，再按 F12 —— 若没输出ctags_jump_to_definition，说明快捷键根本没触发插件 - 右键项目根目录 →
CTags: Rebuild Tags，看控制台是否报command not found: ctags或权限错误（Windows 杀软常拦ctags.exe）
大型项目里，ctags 的本质是正则扫描，对 @decorator、宏展开、getattr 动态调用这类情况不索引——不是你参数没加对，是它能力边界如此。真要查调用链，得切到 LSP + clangd 或 cscope，CTags 只负责把“定义在哪”这件事做稳。
