Sublime Text符号索引需满足项目加入、语法正确、文件已保存三条件；Ctrl+R/F12失效多因语言标识错误、未保存文件、复合语法未配置或单文件模式；索引异步完成，状态栏显示“Indexing…”时跳转静默失败。
Sublime Text 的符号索引不是自动全量扫描的，它只在明确加入项目、语法识别正确、文件已保存的前提下才构建；跳转失效时，90% 问题出在这三步上，而不是插件或配置。
为什么 Ctrl+R 或 F12 总是“没反应”
Ctrl+R（当前文件大纲）和 F12（跳转定义）都依赖 symbol_list，而这个列表由语法高亮规则（.tmLanguage）中定义的 symbol_list scope 规则生成，不是靠解析 AST。常见失效原因：
- 右下角语言标识显示
Plain Text：点它手动选成JavaScript、Python等，否则解析器根本不会运行 - 文件未保存：临时文件或未保存的
.ts文件常不触发索引，先按Ctrl+S -
.vue、.tsx等复合语法需额外配置：默认只识别<script>块内顶层function和class，const fn = () => {}类型基本不进列表 - 单文件模式打开：Sublime 不会为孤立文件建跨文件索引，必须通过
Project → Add Folder to Project加入整个目录
项目级符号索引何时真正生效
原生索引是异步后台行为，不是“打开即有”。关键信号在右下角状态栏：
- 首次添加项目文件夹后，会出现
Indexing…，持续 2–5 秒（大项目可能更久），此时所有跳转命令静默失败 - 索引完成后状态栏恢复为空或显示当前语法名，
Ctrl+P @xxx才开始返回结果 - 检查项目配置：
.sublime-project中若存在"index_files": false，需删掉或设为true（默认就是true，但有人为提速手动关过） - 索引范围仅限于
folders数组中声明的路径，子目录不自动递归——除非你用了"follow_symlinks": true且路径合法
如何验证符号是否被正确捕获
别猜，直接看 Sublime 是怎么“看见”你的函数的：
- 打开一个含
function myUtil() {}的 JS 文件，保存后按Ctrl+R，输入myU看是否出现；若无，说明语法规则没命中该声明形式 - 在相同文件里加一行
class MyClass {}，再试Ctrl+R—— 如果MyClass出现但myUtil不出现，说明当前语法定义（如JavaScript.sublime-syntax）只支持 class 声明，不支持 function 声明的 symbol_list 提取 - 用
Ctrl+Shift+P运行Developer: Show Scope Name，把光标停在函数名上，看输出里是否含entity.name.function—— 这是 symbol_list 能识别的关键 scope - 如果 scope 名是
variable.other.readwrite或meta.function.js，大概率不会被索引进大纲
CTags 是补救还是替代
CTags 不是“更好”的索引，而是另一套机制：它绕过 Sublime 原生语法分析，直接文本扫描生成 tags 文件。适用场景明确：
- 原生索引对某语言完全失效（如旧版
.rs或自定义 DSL） - 需要跳转到
const x = define(...)这类宏/DSL 定义处 - 团队统一使用 CTags，要求
tags文件可提交、可复现
但要注意：ctags -R 默认不处理 node_modules 或 .git，务必加 --exclude=.git --exclude=node_modules；生成的 tags 文件应加进 .gitignore，避免误提交；启用 CTags 插件后，F12 行为会被覆盖，原生 goto_definition 失效——两者不可混用。
