Sublime补全卡顿主因是索引无关文件、插件冲突及设置不当;应排除node_modules等目录、调auto_complete_delay为50、禁用Anaconda与LSP共存,并验证Python解释器路径。

补全卡顿、延迟高、弹不出,八成不是Sublime本身慢,而是它在索引你根本不需要的文件,或插件在后台互相抢资源。
为什么补全变慢?先看这三类典型负担
Sublime 的补全性能瓶颈通常来自三处:项目里混着大量无关文件、插件之间打架、原生设置没对齐真实使用场景。
-
node_modules、__pycache__、.git这类目录被默认纳入索引范围,Sublime 会逐个扫描它们生成符号表——哪怕你从不点开这些文件 -
LSP和Anaconda同时启用,两者都试图启动 Python 分析服务,结果一个等另一个释放端口,补全直接挂起 -
auto_complete_delay设为 0 或负数,导致每敲一个字母都触发一次补全请求,UI 线程被高频打断
怎么快速减负?改三个关键配置项
不用卸插件、不用重装,直接编辑 Preferences → Settings – User:
- 用
"folder_exclude_patterns"排除干扰目录:["node_modules", "__pycache__", ".git", ".vscode"] - 把
"auto_complete_delay"调到50(单位毫秒),既不拖沓也不抢节奏 - 确认
"binary_file_patterns"包含常见二进制后缀:["*.jpg", "*.png", "*.pdf", "*.zip"],避免误索引
Anaconda 和 LSP 别共存,选一个就足够
两者都提供 Python 补全,但机制冲突:Anaconda 启动本地 anaconda_server,LSP-pyright 则拉起独立进程;同时开容易出现 OSError: [Errno 98] Address already in use 或 CPU 持续 100%。
- 专注写 Python 且需要快速上手 → 只留
Anaconda,关掉LSP插件(在Preferences → Package Control → Disable Package里操作) - 项目复杂、需跨文件跳转/类型提示 → 卸载
Anaconda,只用LSP+LSP-pyright,并在LSP.sublime-settings中加"pyright": {"settings": {"python.defaultInterpreterPath": "/path/to/python"}} - 无论选哪个,都必须验证解释器路径是否真能跑:
python -c "import os; print(os.path)",别信which python输出的软链接
注释/字符串里想补全?不是功能缺失,是默认关着
Sublime 原生不进注释区补全,Anaconda 默认继承这个行为。所以你在 # os. 后看不到提示,不是 bug,是开关没开。
- 打开
Preferences → Package Settings → Anaconda → Settings – User - 加一行:
"anaconda_complete_in_comments": true - 注意:该设置只影响
#开头的注释,不影响字符串内(如"os.")或 import 语句右侧 - 如果开了仍无效,检查
"auto_complete_selector"是否包含source.python,否则整个 Python 语法域都会被跳过
真正卡住的地方,往往藏在“我以为它该自动工作”的地方:比如以为 anaconda_complete_all_names 能让所有标准库函数即打即出,结果发现 numpy 里一堆 __getattr__ 动态属性它压根解析不了——这不是配置问题,是 AST 解析器的能力边界。遇到这类情况,与其调参数,不如换思路:用 LSP-pyright 配合 pyrightconfig.json 开启 typeCheckingMode: basic,反而更稳。



















