sublime text 卡顿主因是索引与插件缓存残留,须同步清理 cache、index、local 三目录,并禁用 index_files 可即时缓解但牺牲 ctrl+p/r 功能。

Sublime Text 运行代码本身不产生“运行缓存”,真正拖慢、卡死、跳转失效的,是它在后台默默构建和复用的索引与插件状态——尤其是你用 LSP-pyright、texlab、anaconda 这类语言服务插件时,它们的编译产物和符号缓存一旦残留,重装同名插件会直接加载旧索引,照样卡。
删 Cache 目录只是第一步,必须连 Index 和 Local 一起动
只清 Cache 文件夹,大概率解决不了 Goto Definition 失效或 CPU 持续 100%。因为:
-
Index文件夹(和Cache同级)存的是全文搜索和符号跳转的底层数据库,损坏后 Ctrl+R、Ctrl+P 就变“假响应” -
Local目录(如%APPDATA%\Sublime Text\Local)存窗口折叠状态、崩溃恢复快照、UI 布局,长期不清理会导致启动卡顿、菜单错位 - Windows 用户尤其容易漏掉
%LOCALAPPDATA%\Sublime Text\Cache,这里藏了 LSP 插件最顽固的编译缓存
插件卸载后还在吃 CPU?重点查 Packages/User 和 Cache 下的同名残留
Package Control 的 Remove Package 只删主代码,完全不管配置、缓存、命令绑定。常见表现:
- 右键菜单里还有 “Format with Black”,但点开报错 —— 说明
Packages/User/Black.sublime-settings或Cache/black/没清 - CPU 狂飙,任务管理器看到
pyright进程仍在跑 ——Cache/pyright/整个文件夹还躺在%LOCALAPPDATA%\Sublime Text\Cache\里 - 命令面板能搜到
LSP: Restart Server,但执行失败 ——Packages/User/LSP-pyright.sublime-settings还在,且指向已不存在的二进制路径
实操建议:关掉 Sublime 后,进 Packages/User/ 搜插件名,删掉所有 *.sublime-settings 和 *.sublime-commands;再进各 Cache 路径,用文件名搜索(如 pyright),整文件夹干掉。
禁用 index_files 能立刻止痛,但得接受 Ctrl+P/Ctrl+R 失效
如果你常开含 node_modules 的前端项目,index_files 是卡顿主因。关它比删缓存还快:
- 打开
Preferences → Settings,在右侧用户设置中加一行:"index_files": false - 必须完全退出 Sublime(不是重载设置),再重启才生效
- 副作用明确:Ctrl+P 模糊搜索、Ctrl+R 符号跳转基本不可用;若需保留部分能力,可配合
"folder_exclude_patterns": ["node_modules", ".git"] - 注意别开
re_index_on_load,它只对单文件有效,开错反而每次开脚本都卡住
别信 Index Rebuild 命令面板,它只修表面,不碰病根
Ctrl+Shift+P → Index Rebuild 只重建当前项目索引,对以下问题完全无效:
- 全局索引损坏导致的跨项目跳转失败
-
Cache/pyright/里损坏的 Python 类型缓存 -
Local/中碎片化的 UI 状态引发的启动延迟 - 系统级缓存路径(如 macOS 的
~/Library/Caches/Sublime Text/)中 LSP 插件的二进制产物
真要重建,必须先删干净三处:Cache、Index、Local/Index(路径见上文),再重启。首次打开项目稍慢是正常的,那是它在安静建新索引,不是卡。
%APPDATA% 下的 Cache,却放任 %LOCALAPPDATA% 里的 pyright 编译缓存继续复活;或者删了 Cache 却留着 Local/,结果下次启动窗口布局全乱、侧边栏自动收起。这些路径差一级,效果天壤之别。











