关掉 index_files 是最快见效的一步:默认开启会扫描 node_modules 等目录导致卡顿,需在用户设置中添加 "index_files": false 并彻底重启生效;副作用是 ctrl+r 和 find all references 失效,但 ctrl+p 和 ctrl+shift+f 不受影响。

关掉 index_files 是最快见效的一步
Sublime 启动卡顿,八成以上是因为 index_files 默认开启,一打开项目就同步扫描 node_modules、.git、dist 这类目录——几万次 stat() 调用直接堵死主线程,CPU 拉满、内存飙高、光标延迟全由此来。
操作很简单:打开 Preferences → Settings,在右侧用户设置中加一行:
"index_files": false
必须完全退出 Sublime(任务管理器/活动监视器里确认 sublime_text.exe 或 Sublime Text 进程已消失),再重启才生效。只重载设置或 Cmd/Ctrl+R 无效。
副作用很明确:Ctrl+R(跳转函数/符号)、Find All References 失效;但 Ctrl+P(文件名搜索)、Ctrl+Shift+F(全局文本搜索)完全不受影响。
哪些插件最该优先禁用
GitGutter、SublimeLinter、sublime-lsp、SideBarEnhancements 这几类插件,在大项目根目录下极易引发启动阻塞:它们要么启动时同步加载,要么后台常驻监听,要么依赖外部进程(如 pylsp、pyright),一开就 fork、解析、建 AST。
验证是否是插件问题:按住 Ctrl(Windows/Linux)或 Cmd(macOS)再双击图标启动——如果秒开,问题 100% 出在插件或配置上。
安全做法不是直接卸载,而是先禁用:
- 打开命令面板
Ctrl+Shift+P,输入Package Control: Disable Package - 优先禁用
GitGutter(可先试"non_blocking": true)、SublimeLinter、sublime-lsp - 禁用后观察控制台
Ctrl+`,看是否还有timeout waiting for git status或unresolved import sublime_plugin类报错
缓存不清理,优化效果打五折
残留的 Session.sublime_session、Index/ 和多处 Cache/ 目录,会悄悄拖慢冷启动——尤其 Windows 用户常只清 %APPDATA% 路径,漏掉 %LOCALAPPDATA%\Sublime Text\Cache,导致 LSP 插件缓存顽固残留。
必须连删三处,且顺序不能错:
- 先彻底退出进程(任务管理器 / 活动监视器 /
pkill -f "sublime_text") - 删除:
Cache/、Local/Index/、Local/Session.sublime_session - Windows 路径示例:
%APPDATA%\Sublime Text\Local\Index\、%LOCALAPPDATA%\Sublime Text\Cache\ - macOS 路径示例:
~/Library/Application Support/Sublime Text/Local/Index/、~/Library/Caches/Sublime Text/
删完首次启动稍慢是正常的——它在重建干净的基础缓存,但不会再加载旧索引。
不想彻底关索引?用 folder_exclude_patterns 精准排除
如果你仍需要 Ctrl+P 或 Ctrl+R 在源码里跳转,就别全局关 index_files,改用项目级排除更稳妥。
操作路径:Project → Edit Project,在 folders 块里加入:
"folder_exclude_patterns": ["node_modules", ".git", "__pycache__", "dist", "build", "logs"], "file_exclude_patterns": ["*.log", "*.tmp", "*.zip"]
这个配置对 LSP 插件也生效(比如 pylsp 不再扫描 node_modules 里的 Python 文件),但只对当前项目有效;用 subl . 命令行打开时,需确保当前目录下有 .sublime-project 文件。
注意:右键侧边栏 → Add to Project Exclude List 是实时生效的快捷方式,适合临时排除单个文件夹。
真正卡顿的根源往往藏在“默认开启”和“长期积累”里——index_files 默认开、插件默认装、缓存默认留。优化不是调一堆参数,而是把不该干的活停掉,把不该扫的目录藏起来,把不该锁住的文件删干净。做完这四步,5–8 秒的启动时间压到 0.8 秒以内,是常态,不是例外。











