右下角显示plain text则索引完全失效，因sublime符号跳转（goto definition、ctrl+r、@搜索）依赖语法识别；需点击右下角选对语言或用ctrl+shift+p输入ssjs切换，并通过show scope name确认出现source.js才算生效。
右下角显示 Plain Text 就别指望索引能工作
Sublime 的符号索引（Goto Definition、Ctrl+R、@前缀跳转）完全依赖语法识别。如果右下角写着 Plain Text，说明它根本没加载任何语法规则，自然不会解析 function、export 或 class —— 所有索引行为都停摆。
立即验证：点右下角文字 → 选对语法（如 JavaScript）；或按 Ctrl+Shift+P 输入 ssjs 回车。再按 Ctrl+Shift+P 输入 Developer: Show Scope Name，输出里出现 source.js 才算真正就位。
常见诱因：
-
ignored_packages里误加了"JavaScript"或"Default"（禁用Default会直接干掉 Unicode 安全过滤和基础符号提取逻辑） - 文件扩展名未绑定语法，比如
.ts被识别为Plain Text，需手动绑定或装JavaScriptNext - ES6 Syntax类包 - 从微信、Notion 复制的代码带
\u202E（RTL 控制符），触发解析器卡死，Developer: Show Scope Name会返回invalid.illegal
Indexing… 一直不消失？先看是不是项目没加对
Sublime 不索引“单个打开的文件”，只索引“项目里的文件夹”。双击一个 index.js 打开，Goto Definition 必然失效——它压根不在索引范围内。
必须执行：Project → Add Folder to Project…，把含 src/、lib/、package.json 的根目录加进来。添加后状态栏若没立刻显示 Indexing…，可手动触发：Project → Index Files Now。
Monorepo 场景要特别注意：
-
folder_exclude_patterns（如["node_modules", "dist"]）只在当前文件夹生效，不会递归过滤packages/a/node_modules - 必须把每个子模块的
src目录单独列为folders条目，例如：{"path": "packages/core/src"} - 全局
"index_files": true在 Monorepo 下是灾难源，应设为false，改用项目级显式声明
索引建好了但跳转还是错乱或失败
索引完成 ≠ 跳转可靠。原生符号索引在多包、同名导出、TS interface 等场景下极易误匹配。比如 packages/utils/src/debounce.ts 和 packages/api/src/debounce.ts 都导出 debounce，Ctrl+Click 可能跳到错误位置。
解决方案不是硬调参数，而是绕过原生限制：
- 关掉全局
symbol_index："symbol_index": false（写入Preferences.sublime-settings） - 按需启用：右键 →
Index Symbols in Folder，且确保该文件夹不含node_modules - 对 JS/TS，装
SublimeLSP+typescript-language-server，跳转基于语言服务器，不依赖 Sublime 原生索引 - 对 Python，用
SublimeJEDI替代原生功能，支持async def、类型提示等
另外，large_file_size_limit 设再大也没用——如果索引线程正在扫描一个 500MB 的日志文件，detect_indentation、highlight_line、gutter 全开着，照样卡死。这些必须同步关掉。
删缓存不彻底等于白干
索引损坏最典型的症状是：Ctrl+P 能搜到函数名，但 Ctrl+Click 点不动；或者状态栏长期卡在 Indexing 0/1 files，Indexing: Show Indexing Status 提示 crawldb not available。
这不是删 Cache 目录能解决的。Index 是独立数据库，路径分散且常被进程锁住：
- Windows：
%APPDATA%\Sublime Text\Local\Index和%LOCALAPPDATA%\Sublime Text\Local\Index（两个都要删） - macOS：
~/Library/Application Support/Sublime Text/Local\Index和~/Library/Caches/Sublime Text/Local\Index - Linux：
~/.config/sublime-text/Local\Index和~/.cache/sublime-text/Local\Index
关键动作：必须先彻底退出 Sublime（任务管理器里确认 subl 进程已清空），再删 Index 文件夹。删完重启，它会自动重建——这才是真正重置索引的唯一方式。
