sublime text 的符号索引失效根本原因是索引状态损坏或被锁死：lsp 插件占用数据库、语法识别失败（右下角显示 plain text）、未通过 open folder 加载项目；修复需彻底退出进程后同步清理 index、cache 和 local 文件夹。
Sublime Text 的符号索引（Goto Definition、@搜索等依赖的底层数据）不存于单一文件，而是分散在 Index 文件夹里的 SQLite 数据库和临时缓存中；只清 Cache 无法修复跳转失效，必须连同 Index 和 Local 一并清理，且进程必须彻底退出。
为什么 @ 搜索或 Goto Definition 失效？
根本原因不是插件没装，而是索引状态损坏或被锁死：LSP 插件（如 pyright）可能正占用 Index 下的数据库文件；右下角显示 Plain Text 时，语法识别失败，索引压根不会触发；项目未通过 File → Open Folder… 加载，Ctrl+P 的符号模式（@）直接不可用。
- 首次输入
@func后右下角卡在Indexing files…？说明索引尚未完成，不是功能坏了 - 改过项目结构（如新增
src/utils/）后搜不到新函数？需手动执行Refresh Folders，不是Rebuild Index - TypeScript/JSX 项目符号跳转弱？建议启用
JS Custom插件的enable_auto_symbol_indexing
Index 文件夹在哪？删它会不会丢配置？
Index 是纯文件夹名，不是 Index Files 或项目级缓存；它只存符号索引和全文搜索的底层数据库，删掉不影响 Packages、Settings 或 License。但必须和 Cache、Local 同步清理，否则残留状态会互相干扰。
- Windows：
%APPDATA%\Sublime Text\Local\Index和%LOCALAPPDATA%\Sublime Text\Local\Index——两个都得进，别漏后者 - macOS：
~/Library/Application Support/Sublime Text/Local/Index和~/Library/Caches/Sublime Text（后者虽叫 Caches，但部分索引元数据也混在里面） - Linux：
~/.config/sublime-text/Local/Index和~/.cache/sublime-text - 注意：
Index文件夹内没有.sublime-project，那是项目配置，别误删
清理前必须杀光进程，否则白忙活
窗口关闭 ≠ 进程退出。Sublime Text 4 默认后台常驻，plugin_host、LSP server、同步监听器全在跑，会锁死 Index 下的 SQLite 文件。删一半卡住、删完重启立刻重建旧索引——都是因为进程没杀干净。
- Windows：任务管理器 → 搜
sublime_text.exe和subl.exe→ 全部结束 - macOS：活动监视器 → 搜
Sublime Text和plugin_host→ 强制退出所有匹配项 - Linux：终端运行
pkill -f "sublime_text"，再用ps aux | grep sublime确认无残留 - 安全模式（Cmd/Ctrl 启动）不能替代杀进程，它只是跳过插件加载，
Index读写线程照常运行
插件卸载后符号跳转还卡？重点扫 Packages/User 和 Cache 子目录
Package Control: Remove Package 只删插件代码和 .sublime-package，完全不管配置、缓存、状态文件。卸载 LSP-pyright 后，Cache/pyright/ 里仍存着旧类型数据库；Packages/User/LSP-pyright.sublime-settings 若还在，重启时可能触发异常初始化。
- 进
Packages/User/目录，搜插件名（如pyright、black），删所有*.sublime-settings、*.sublime-commands、*.sublime-theme - 进
Cache/目录，找同名子文件夹（如pyright/、texlab/），整夹删除 - 删完启动时若 CPU 飙高，大概率是某个 LSP 进程从残留缓存里复活了，回头再查
Cache/是否清净
真正影响符号跳转的从来不是单个文件路径，而是 Index 数据库与当前语法识别、项目加载状态之间的三者对齐；删错一个路径、漏杀一个进程、留一个 Packages/User 配置，都可能导致 @ 搜索半途卡死或返回空结果。
