sublime text无“索引深度”参数，卡顿源于索引范围过大；需在.sublime-project中配置folder_exclude_patterns和file_exclude_patterns精准排除无关目录与文件，而非调整深度。
索引范围由folder_exclude_patterns和file_exclude_patterns控制，不是“深度”参数
Sublime Text 没有叫“索引深度”的配置项。所谓“索引太深卡顿”，其实是索引扫描了太多无关目录（比如node_modules、__pycache__），导致解析器反复加载低价值文件、内存暴涨、缓存失效。真正要调的是**哪些路径进索引**，而不是“进几层”。
关键点：
-
index_files: true只是开关，不决定范围；范围全靠folder_exclude_patterns和file_exclude_patterns - 这些排除规则必须写在
.sublime-project里才精准——全局设置会误伤其他项目 - 大小写敏感：
Node_modules不会被"node_modules"排除，Windows 下也得小写 - 排除后不会重建整个索引，但新加入的匹配路径将跳过扫描
Ctrl+P @搜不到符号？先检查索引是否已就绪且文件未被排除
输入@function_name后列表为空或延迟严重，90% 是因为索引没建完或目标文件根本不在索引范围内。
实操步骤：
- 看右下角状态栏：显示
Indexing...时必须等它消失，不能强行搜索 - 确认文件已保存：
Ctrl+S是触发索引更新的硬性前提，未保存内容不参与索引 - 打开
Preferences → Settings – Project，检查"folder_exclude_patterns"是否误写了"src"或"utils"这类业务目录 - 用
Ctrl+Shift+P → Index Files: Rebuild Index手动触发，比等自动更可控
为什么.ts或.vue文件里的函数不进Ctrl+R列表？语法包缺symbol_list
Ctrl+R只读当前文件的symbol_list作用域，而这个列表由语法定义（.sublime-syntax）提供。原生 TypeScript 或 Vue 语法包默认不带完整symbol_list规则，所以class A { method() {} }可能被识别，但const fn = () => {}直接消失。
验证与修复：
- 点右下角语言标识，确保是
TypeScript而非Plain Text；后缀.ts≠自动启用语法解析 - 安装社区增强包，如
JavaScriptNext - ES6 Syntax（对 JS/TS 更友好）或Vue Syntax Highlight - 不推荐改原生语法文件：升级后会被覆盖；优先用
.sublime-project绑定语法："syntax_override": {"*.ts": "Packages/JavaScriptNext/JavaScriptNext.tmLanguage"}
大型项目首次索引慢？别等自动，用Index Files: Rebuild Index主动接管
索引是异步的，但失败不重试、中断不恢复。关机未退出、插件冲突、大体积日志文件都可能导致索引卡在“正在重建”状态长达数分钟，且无报错提示。
可靠做法：
- 删掉旧索引：
rm -rf ~/.config/sublime-text-4/Index/（Linux/macOS）或%LOCALAPPDATA%\Sublime Text 4\Cache\Index\（Windows） - 确保
.sublime-project中"index_files": true且folder_exclude_patterns已精简 - 执行
Ctrl+Shift+P → Index Files: Rebuild Index，观察状态栏进度；失败会在控制台（Ctrl+`）输出具体路径和错误 - 若某目录反复失败（如含大量
.log或二进制），加进file_exclude_patterns："*.log", "*.bin"
最易被忽略的是：索引重建后，Ctrl+P @仍需等 1–2 秒响应——这不是卡顿，是 Sublime 在后台做符号去重和缓存填充，强行重复触发反而让队列更长。
