Goto Symbol 搜不到刚写的函数是因为 Sublime Text 默认只索引已保存文件；未保存的修改不会被符号数据库收录，需先保存（Ctrl+S/Cmd+S）再搜索。
为什么 Goto Symbol 搜不到刚写的函数？
因为 Sublime Text 默认只索引已保存的文件，未保存的修改不会被符号数据库收录。你改完一个函数名、按 Ctrl+R（Windows/Linux）或 Cmd+R（macOS）搜不到，大概率是文件还没存盘。
- 务必先按
Ctrl+S或Cmd+S保存文件，再触发Goto Symbol - 如果用了插件如
EasyMotion或自定义快捷键，检查是否覆盖了默认的Ctrl+R绑定 - 部分语法高亮包（比如旧版
Vue Syntax Highlight）不提供 symbol scope 定义，会导致.vue文件里的<script>函数无法被识别
Ctrl+R 列表里一堆重复项，怎么过滤？
这是 Sublime Text 把不同作用域（比如类定义、方法、变量）全混在一起显示的结果。它本身不区分“跳转到函数”还是“跳转到类”，只按符号声明顺序列出来。
- 输入时直接打函数名前缀，比如搜
init，列表会实时过滤出所有含该子串的符号 - 加
@前缀可强制限定为“函数/方法”：输入@init，就能排除掉变量和类名 - 加
#前缀则限定为“类/对象”：输入#User只显示类定义 - 注意：这个
@/#过滤依赖语法定义，Python、JS、Go 支持较好；纯文本或自定义后缀文件可能无效
自定义语言或新后缀文件不支持 Goto Symbol 怎么办？
Sublime Text 的符号跳转能力完全靠 .sublime-syntax 文件里的 symbol_list 规则驱动。没定义，就等于没告诉编辑器“哪些文本算符号”。
- 打开命令面板（
Ctrl+Shift+P），运行Tools → Developer → Show Scope Name，把光标放在目标函数名上，看底部状态栏显示的 scope 是什么（比如source.python meta.function.python） - 找到对应语法定义文件（通常在
Packages/Python/Python.sublime-syntax这类路径），确认是否有symbol_listsection 和匹配该 scope 的 rule - 若要支持新后缀（如
.foo），需在语法文件中添加file_extensions，并在symbol_list里补一条针对其 scope 的正则捕获规则 - 临时验证可用
View → Syntax → Open all with current extension as…手动指定已有语法（比如把.foo当作 Python 用），看是否恢复跳转
跳转后光标停在错误位置，比如函数名开头而不是定义行？
这是 symbol pattern 捕获组写法导致的——Sublime 默认把第一个捕获组（(...)）当跳转锚点。如果正则里把修饰符（如 async、static）也包进第一组，光标就会落在修饰词上。
- 正确写法应让函数名本身成为第一捕获组，例如 Python 的典型 pattern：
^\s*(async\s+)?(def|class)\s+([a-zA-Z_]\w*)→ 第三组([a-zA-Z_]\w*)是函数名，但必须设为symbol_name对应的 group - 检查语法文件中
symbol_list下的match行，确保关键标识符在第一个有效捕获组内，或显式指定name键 - 第三方语法包（如
Babel）有时为了兼容老版本 Sublime，会用错 group 顺序，升级插件或切回官方JavaScript语法常能解决
真正卡住的地方往往不是快捷键记不住，而是符号能不能被识别、识别成什么、以及识别依据在哪——这些都藏在语法定义里，而不是设置菜单中。
