根本原因是符号索引未建立或损坏：需保存文件、正确设置语言类型、通过project→add folder to project添加根目录并等待indexing完成，同时确保"index_files": true且无进程锁住cache/index目录。
为什么Ctrl+R、F12、Ctrl+Click全失效？索引根本没建起来
不是快捷键坏了，也不是插件没装——Sublime Text 的符号跳转（goto_definition、Ctrl+R、Ctrl+P+@）全部依赖后台构建的符号索引。一旦索引卡住、损坏或压根没触发，所有跳转行为都会静默失败：不报错、不弹窗、列表为空、光标悬停无响应。
最直接线索在右下角状态栏：Indexing… 长期不消失，或干脆没出现；Help → Index Status 显示 indexing: crawldb not available, indexing abandoned；或者命令面板里搜不到 Index Files 相关命令——这说明索引链路从底层就断了。
- 单文件打开模式下，索引默认不启动；必须通过
Project → Add Folder to Project显式添加项目根目录 - 文件未保存时，修改内容不会参与索引重建；按
Ctrl+S是强制刷新索引的最小成本操作 - 右下角显示
Plain Text？点它手动选成对应语言（如Python、JavaScript），否则语法解析器不加载，符号提取直接跳过 -
"index_files": true必须在用户设置或项目设置中显式存在（默认开启，但常被人为关掉提速）
清 Cache 和 Index 之前，必须杀光所有 Sublime 进程
只删目录不够，漏一个残留进程，Index 下的 SQLite 文件就会被锁住，删完重启照样卡在“Searching…”或 Indexing abandoned。
- Windows：任务管理器里结束所有
sublime_text.exe和subl.exe；也可用命令行taskkill /f /im sublime_text.exe+taskkill /f /im subl.exe - macOS：活动监视器中搜索
Sublime Text，连带Sublime Text Helper进程一起强制退出 - Linux：
pkill -f "sublime_text"或pkill -f "subl"，再用ps aux | grep sublime确认无残留
杀净后，再删以下两处（二者缺一不可）：
-
Cache：存插件临时产物（如 LSP-pyright 的.pyc、GitGutter 的.diff），损坏会导致路径扫描跳过 -
Index：存全文搜索和符号跳转用的 SQLite 数据库，损坏或锁住即导致静默失败
路径参考：
Windows：%APPDATA%\Sublime Text\Cache、%LOCALAPPDATA%\Sublime Text\Cache、%APPDATA%\Sublime Text\Index
macOS：~/Library/Application Support/Sublime Text/Cache、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Index
Linux：~/.config/sublime-text/Cache、~/.cache/sublime-text、~/.config/sublime-text/Index
清完别急着搜，先关 index_files 再重启
缓存清干净了，但如果 "index_files": true（默认值）仍开着，Sublime 会在后台自动重建索引——尤其含 node_modules 或 __pycache__ 的项目，这个过程会阻塞 Find in Files 和 goto_definition 请求，表现为卡死、无响应、空结果。
- 打开用户设置（
Preferences → Settings），加一行："index_files": false - 重启 Sublime，此时
Find in Files会走实时扫描（不依赖索引），反而更可靠 - 若需跨文件跳转或符号导航，等启动稳定后，手动执行
Project → Index Files，而不是让它自动后台跑
注意：Project → Index Files 不是“立刻完成”，它只是触发重建；右下角再次出现 Indexing…，等它消失才算就绪。
LSP 插件跳转失效？检查 Python 版本兼容性与服务状态
原生索引只支持基础符号（函数名、类名），复杂跳转（如类型推导、跨包引用）依赖 LSP 类插件（如 subl-lsp、SublimeJEDI）。但 ST4 默认运行在 Python 3.8+，很多老插件（如旧版 AutoFileName、SublimeJEDI）因用 urllib2 或 imp 模块而静默不加载——控制台无报错，Preferences → Package Settings 里菜单还在，但功能完全失活。
- 查控制台（
Ctrl+`）：有无ImportError或ModuleNotFoundError提示 - 确认插件是否真在运行：比如
subl-lsp启动后，状态栏应显示LSP-Python或类似标识 - Python 路径配置错误也会导致 LSP 服务起不来：在插件设置中检查
python_package_paths是否指向正确的 site-packages - ST4 上推荐用
subl-lsp+pyright组合，避免用已停止维护的anaconda或SublimeJEDI
真正容易被忽略的是：LSP 跳转对编码格式敏感——UTF-8 with BOM、混合换行符（CRLF/LF）、非 ASCII 文件路径，都可能导致服务拒绝解析或返回空响应。
