Sublime Text卡顿等问题90%源于插件残留、缓存堆积与index_files扫描叠加;须彻底退出进程后手动清理Packages/User、Cache、Local/Index三处路径,并登出同步账号。

Sublime Text 启动慢、CPU 飙高、右键菜单残留、Goto Definition 失效——这些问题 90% 不是编辑器本身的问题,而是插件残留 + 缓存堆积 + index_files 扫描三者叠加导致的。真优化不是“禁用几个插件”,而是清干净、关到位、留得住。
Package Control 卸载插件后命令还在?这是正常现象
因为 Package Control: Remove Package 只删两样东西:Packages/PluginName/ 目录和 Installed Packages/PluginName.sublime-package,其余全留着:
-
Packages/User/PluginName.sublime-settings还在,可能触发旧逻辑或报错 -
Packages/User/Default (Windows).sublime-keymap里硬编码的"command": "git_gutter"快捷键照常生效 -
Packages/User/PluginName.sublime-commands或Context.sublime-menu文件没动,右键菜单项继续显示 - LSP 类插件(如
pyright、texlab)在Cache/下留的 socket 和索引文件,Sublime 启动时仍会尝试连接,CPU 持续 30%~100%
必须手动清理的三个残留位置
关死所有 Sublime 进程(窗口关了 ≠ 进程退出)后,按系统路径逐个清理:
-
Packages/User/:进
Preferences → Browse Packages…,搜索插件名(如pyright、gitgutter),删掉所有匹配的*.sublime-settings、*.sublime-keymap、*.sublime-commands、*.sublime-menu;再打开Preferences.sublime-settings,删掉整行残留字段,比如"lsp_format_on_save": true或"ignored_packages": ["LSP-pyright"] -
Cache/:Windows 进
%LOCALAPPDATA%\Sublime Text\Cache\搜关键词删整个文件夹;macOS 删~/Library/Caches/com.sublimetext.4/和~/Library/Saved Application State/com.sublimetext.4/(后者会偷偷恢复插件状态);Linux 执行rm -rf ~/.cache/sublime-text/*(安全,重启自动重建) -
Local/ 和 Index/:这些目录藏在同级路径下,比如 Windows 的
%LOCALAPPDATA%\Sublime Text\Local\Index,macOS 的~/Library/Application Support/Sublime Text/Local/Index,Linux 的~/.config/sublime-text/Local/Index;不删它,Goto Definition和全文搜索就一直卡
index_files 关不关?怎么关才不丢功能
index_files 是启动时全项目扫描构建跳转数据库的功能,遇到含 node_modules 或 .git 的大目录,光是 stat() 系统调用就能卡死主线程。关它最立竿见影:
- 进
Preferences → Settings,右侧用户设置加一行:"index_files": false - 副作用明确:
Ctrl+R(跳函数定义)、Ctrl+Click(跳转)、Find All References全部失效;但Ctrl+P(按文件名搜索)、Ctrl+Shift+F(全局文本搜索)仍可用 - 若仍需部分能力,别全局关死,改用项目级排除:在
Project → Edit Project中加:"index_exclude_patterns": ["node_modules/", ".git/", "dist/"]
同步没登出,删光也白搭
只要执行过 subl --sync-login,重装后首次启动就会从云端拉回 Preferences.sublime-settings、插件列表、快捷键——这是最常被忽略的“复活”源头:
- 卸载前务必运行:
subl --sync-logout(Windows 需确保subl在 PATH 中;macOS/Linux 直接终端执行) - 或者菜单栏点
Sublime Text → Preferences → Sync Settings → Logout - 不确定是否登过?检查
%APPDATA%\Sublime Text\Packages\User\Package Control.sublime-settings里有没有"sync_login"字段
真正麻烦的从来不是删多少,而是删漏哪一处:Saved Application State 会偷偷恢复插件状态,Local/ 下的 Session 文件会让崩溃恢复机制反复加载坏配置,而 Cache/ 里某个 LSP 插件的残留 socket 文件,可能让 CPU 在你打开编辑器第一秒就开始飙高。











