Ctrl+R找不到函数或类的根本原因是Sublime未正确解析符号作用域，需确保右下角语言标识匹配（如Python/JavaScript）、文件已保存、语法包支持对应结构（如async def需增强包），否则symbol_list为空。
Sublime Text 的符号索引不是“开箱即用就全好使”的功能，它依赖语法定义、索引状态和插件协同。不配置好，Ctrl+R 可能只列出空列表，Ctrl+Shift+R 查不到跨文件函数，F12 跳转直接失效。
为什么 Ctrl+R 找不到你的函数或类
根本原因在于 Sublime 没有为当前语言正确解析出符号作用域。它不靠 AST，而是靠语法高亮包里定义的 scope 规则来识别“哪里是函数名”“哪里是类声明”。如果语法包老旧、不完整，或者你用的是自定义 DSL，Ctrl+R 就会漏掉甚至完全不显示符号。
- 检查当前文件右下角的语言标识（如 “Python”、“JavaScript”），点击确认是否匹配实际语法；如果不是，手动选择正确语法（比如把 .ts 文件设为 “TypeScript” 而非 “Plain Text”）
- 打开
Preferences → Package Settings → [语言名] → Settings，查看是否有symbol_index相关配置项，部分语言包支持开启更激进的符号提取 - 临时测试：新建一个 .py 文件，输入
def hello(): pass，再按Ctrl+R—— 如果能看见hello，说明 Python 语法包正常；如果看不到，大概率是语法包损坏或未加载
Ctrl+Shift+R 搜索不到项目里的符号怎么办
这个功能依赖 Sublime 后台维护的项目级符号缓存，不是实时扫描，也不是全文 grep。它只索引被语法包标记为“符号”的内容（比如 class、def、function 关键字后的标识符），变量、字符串、注释里的名字一律忽略。
- 首次使用前，确保项目已通过侧边栏“Add Folder to Project”加入工作区，纯打开文件不触发项目索引
- 索引是异步构建的，大型项目可能需要几十秒到几分钟——观察状态栏左下角是否显示 “Indexing…”；若长期卡住，可尝试关闭再重开项目
- 某些语言（如 Go、Rust）原生支持弱，必须配合
CTags插件生成tags文件，否则Ctrl+Shift+R基本不可用 - 符号名区分大小写，但匹配本身是模糊的；输入
getuser可能匹配GetUserHandler，但不会匹配get_user_id（下划线分隔默认不参与词元切分）
用 CTags 补足原生索引短板
当 Ctrl+R 和 Ctrl+Shift+R 在 C/C++、Ruby、Elixir 或老旧 PHP 项目中频频失灵，CTags 是最可靠 fallback。它不依赖语法包，而是调用外部 ctags 工具做静态分析，生成的 tags 文件可被 Sublime 直接读取。
- 先装命令行
ctags：macOS 用brew install ctags，Ubuntu 用sudo apt install exuberant-ctags，Windows 推荐Universal Ctags - 在项目根目录运行
ctags -R --fields=+niaz --c-kinds=+p --c++-kinds=+p（加--python-kinds=+i等按需扩展） - Sublime 中安装
CTags插件后，右键项目文件夹 → “Index Current Project”，它会自动找同级tags文件 - 之后
F12和右键 “Go to Definition” 就走 CTags 路径，准确率大幅上升；但注意：重命名函数后必须重新生成tags，它不自动更新
Goto Anything（Ctrl+P）里的符号跳转技巧
Ctrl+P 不只是找文件，它把文件跳转、符号定位、行号跳转揉在一起，组合使用效率极高，但容易忽略语法细节。
- 输入
main.py@handle：打开main.py并跳转到含handle的符号（函数/类），比先Ctrl+P打开再Ctrl+R快一步 - 输入
@init：在当前文件内搜索所有叫init的符号，等效于Ctrl+R，但可在任意上下文触发 - 输入
#TODO：在当前文件中搜索TODO字符串（不区分大小写），适合快速扫注释标记 - 输入
:42：跳转到当前文件第 42 行；若当前没打开文件，会先弹出文件选择面板 - 连续输入
utils.py@load:15：一步到位打开utils.py、跳到load符号、再定位到该符号内部第 15 行（前提是符号本身有多行定义）
真正卡住人的地方往往不是功能不会用，而是不知道索引什么时候生效、失效时怎么验证、以及哪些符号压根就不会被原生机制捕获。别迷信快捷键，先看状态栏有没有 “Indexing…”，再查右下角语法名对不对，最后才动插件——顺序错了，花再长时间调配置也没用。
