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% 的卡顿都能立刻缓解。不复杂但容易忽略。