sublimecodeintel在2026年已不推荐用于新项目，因其静默失效多、索引易坏、不支持现代语言特性且无法响应文件变更；应改用sublimelsp+对应语言服务器（如pylsp、typescript-language-server）。
SublimeCodeIntel 在 2026 年已不推荐用于新项目——它静默失效多、索引易坏、不支持现代语言特性，且无法响应文件变更；真正需要全语言智能提示，请直接用 SublimeLSP + 对应语言服务器（如 pylsp、typescript-language-server）。
为什么 SublimeCodeIntel 经常“看起来装好了，但就是不提示”
它不是纯前端插件，而是一个依赖外部进程的客户端：Sublime Text 启动时会尝试调用系统 PATH 中的 codeintel 命令，该命令扫描项目生成 SQLite 索引（存于 ~/.codeintel），再通过 socket 通信返回结果。一旦任一环节断开，就完全静默——控制台可能只报一句 ImportError: No module named 'codeintel' 或根本无日志。
- 你用 Python 3 写项目，却只运行了
pip install CodeIntel（默认装给 Python 2）→ 必须用pip3 install --upgrade --pre CodeIntel - 右下角长期显示
CodeIntel: indexing卡住 → 很可能是codeintel进程崩溃或被杀，检查终端能否直接执行codeintel --version - 打开 .py 文件后右下角压根没出现任何 CodeIntel 提示 → 查看 Sublime 控制台（
Ctrl + `），重点找socket.error或ConnectionRefusedError - 补全只对
os、sys有效，对自定义模块/第三方包无效 → 默认不扫描项目外路径，必须手动配置scan_extra_paths
如果非要硬上 SublimeCodeIntel，关键配置项不能漏
默认配置几乎不可用，尤其在虚拟环境、多 Python 版本或非标准项目结构下。必须编辑 SublimeCodeIntel.sublime-settings（Preferences → Package Settings → SublimeCodeIntel → Settings – User）：
-
"python"字段要填绝对路径，比如"python": "/Users/you/.pyenv/versions/3.11.9/bin/python"，不能写"python3"或留空 -
"scan_extra_paths"必须显式列出所有含.py的目录，且每个路径下需有__init__.py（否则不识别为包） -
"codeintel_scan_files_in_project"设为true才会扫描当前 Sublime 项目根目录下的文件（否则只扫scan_extra_paths） - JavaScript 项目需额外加
"js_path"指向node_modules根目录，否则无法解析import或require
索引坏了怎么办？重启没用，必须彻底重置
切换 Git 分支、升级依赖、移动项目位置后，~/.codeintel 目录极易损坏——此时补全延迟、跳转失败、提示消失，但没有任何错误提示。
- 先完全退出 Sublime Text：macOS 要右键 Dock 图标选 “Quit”，Windows/Linux 要确认后台
subl进程已结束 - 删除整个索引目录：
rm -rf ~/.codeintel（macOS/Linux）或rd /s /q "%userprofile%\.codeintel"（Windows） - 重新启动 Sublime Text，打开一个目标文件（如
main.py），等待右下角从CodeIntel: indexing变成CodeIntel: ready - 测试是否真生效：把光标停在函数名上，按
Ctrl+Click（Windows/Linux）或Control+Click（Mac），能跳转才算通
真正麻烦的地方不在安装，而在维护：每次 Python 环境变动、项目结构调整、甚至 Sublime Text 小版本更新，都可能让索引或通信链路断裂。如果你的项目需要稳定、低维护的智能提示，SublimeLSP 配合 pylsp 或 typescript-language-server 是目前唯一可靠的选择——它基于 LSP 协议，错误明确、日志可查、服务器独立演进，不会因编辑器小更新而集体失能。
