Sublime Text 索引卡住主因是冗余目录和插件干扰，应优先排除 node_modules 等大目录、禁用 GitGutter 等插件、清理 Indexing 缓存目录，并可设 index_workers 为 1 降低负载。
Sublime Text 的索引卡住，通常是因为文件过多、路径包含大量无用目录，或插件干扰。解决重点是减少索引负担 + 排查干扰源，而不是强行等待。
关闭不需要索引的文件夹和文件类型
索引卡住最常见原因是项目里混入了 node_modules、.git、dist、__pycache__ 等大体积目录。Sublime 默认会递归扫描整个打开的文件夹。
- 右键侧边栏中不想索引的文件夹 → “Add to Project Exclude List”
- 或手动编辑项目文件（Project → Edit Project），加入：
"folder_exclude_patterns": ["node_modules", ".git", "dist", "__pycache__", "*.log"] - 同时可限制索引的文件后缀：
"file_exclude_patterns": ["*.tmp", "*.swp", "*.DS_Store"]
临时禁用可能干扰索引的插件
某些插件（如 GitGutter、SideBarEnhancements、LSP 类语言服务器）会在文件变更时频繁触发索引或监听，导致索引线程阻塞。
- 菜单栏 → Preferences → Package Control → Disable Package
- 逐个禁用近期安装或常驻后台的插件，观察状态栏 “Indexing…” 是否消失
- 确认恢复后，再针对性调整插件设置（例如 GitGutter 可设
"enable_git_gutter": false）
重置索引缓存并限制索引范围
索引元数据损坏或过于陈旧也可能卡死。Sublime 的索引缓存存在本地，可安全清理。
- 退出 Sublime Text
- 删除以下目录（根据系统）：
macOS:~/Library/Application Support/Sublime Text/Indexing/Windows:%APPDATA%\Sublime Text\Indexing\Linux:~/.config/sublime-text/Indexing/ - 重启 Sublime，它会重新建立轻量级索引；如果仍卡住，说明仍有目录未排除，回到第一步检查
降低索引优先级（高级选项）
对低配设备或超大项目，可让 Sublime 更“佛系”地索引，避免抢夺 UI 响应资源。
- 菜单栏 → Preferences → Settings – User
- 添加以下配置（仅限 Sublime Text 4）：
"index_files": true,"index_workers": 1,"index_include_search_history": false -
"index_workers": 1强制单线程索引，更稳定；false关闭搜索历史索引，减少后台压力
基本上就这些。索引不是必须实时满负荷运行的功能——关掉冗余路径、停掉干扰插件、清一次缓存，90% 的卡顿都能立刻缓解。不复杂但容易忽略。
