Goto Definition 失效主因是索引未就绪：需确认右下角无“Indexing…”、已添加文件夹到项目、语法识别正确，必要时重置索引缓存或安装LSP类插件增强支持。
Sublime Text 的 Goto Definition（跳转到定义）失效，绝大多数情况是索引没建好或没更新——不是插件问题，也不是快捷键冲突，核心在“索引是否就绪”。
确认索引是否已构建完成
Sublime 默认对打开的文件、项目文件夹内容进行后台索引。如果刚添加新文件、切换项目，或 Sublime 重启后还没等完，索引可能为空或不完整。
- 看窗口右下角状态栏：如果显示 “Indexing…” 或长时间卡在 “Indexing 12/156 files”，说明还在干活，稍等几十秒到一两分钟
- 按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac），输入 Indexing: Show Indexing Status，可查看实时进度和错误提示
- 索引完成后，状态栏通常会变为空白或显示当前语法类型，Goto Definition 才真正可用
检查项目是否已正确添加（关键！）
Sublime 不自动索引“当前打开的单个文件”，它只索引“项目（Project）”里的内容。如果你只是双击打开一个 .py 或 .js 文件，没有添加到项目里，定义跳转大概率失败。
- 菜单栏选择 Project → Add Folder to Project…，把整个代码根目录加进来（比如包含 src/、lib/、.git/ 的那个文件夹）
- 确保该文件夹下有你正在编辑的文件，且文件类型被 Sublime 支持（如 Python、JavaScript、TypeScript 等）
- 添加后等待几秒，观察右下角是否开始 indexing；也可手动触发重建：Project → Index Files Now
确认语言支持与符号识别是否启用
Sublime 原生只对部分语言做基础符号索引（如函数名、类名）。如果用的是较新语法（如 TS 中的 interface、Vue SFC、JSX），原生功能可能不识别。
- 先确认当前文件右下角显示的语法是否正确（如 “Python” 而不是 “Plain Text”），点它可切换；错误语法 = 零索引
- 对 JavaScript/TypeScript，建议安装官方推荐插件：SublimeLSP + nodejs-language-server，它提供更准的语义跳转（比原生 Goto Definition 强得多）
- Python 用户可装 SublimeJEDI 或 anaconda（注意后者已停止维护，推荐 Jedi）
临时重置索引缓存（少数顽固情况）
索引文件损坏或残留旧数据也会导致跳转失效，尤其在频繁切换分支、重命名文件夹后。
- 关闭 Sublime Text
- 删除索引缓存文件夹：
Windows：%APPDATA%\Sublime Text\Packages\User\index或整个Index Files目录
macOS：~/Library/Application Support/Sublime Text/Packages/User/index
Linux：~/.config/sublime-text/Packages/User/index - 重新打开 Sublime，添加项目，让它从头建索引
基本上就这些。多数时候，加项目 + 等索引完成，就能恢复跳转。不复杂但容易忽略。
