sublime text 实现 lsp 智能补全需同时满足 package control 已安装、语言服务器 command 可执行、scopes 与 syntaxes 严格匹配三条件;缺一则静默失效,无错误提示。

Sublime Text 本身不带 LSP 支持,所谓“焕发新生”不是靠换皮肤或加插件,而是让 LSP 插件真正连上可用的语言服务器——只要 command 能执行、scopes 和 syntaxes 完全匹配、Package Control 已就位,哪怕 Sublime Text Build 3143(2017 年老版本)也能跑起 pyright 或 typescript-language-server。
Package Control 没装好,LSP 根本启动不了
所有后续操作都依赖它。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS)输入 Package Control: Install Package,如果命令不出现,说明没装。别跳过这步直接搜 LSP。
- 打开
View → Show Console,粘贴官方安装脚本(含哈希校验),回车执行 - 执行完必须重启 Sublime —— 不重启,新插件不会加载,LSP 插件也进不来命令面板
- 重启后再试
Ctrl+Shift+P,能调出该命令才算真正就位
LSP 插件装了但右下角只显示 Plain Text
这是最典型的“语言服务器压根没启动”信号。LSP 插件只是通信管道,不自带任何补全、跳转能力。状态栏不显示 LSP: pyright 或 LSP: typescript-language-server,就等于没通电。
- 先确认当前文件语法:按
Ctrl+Alt+Shift+P(Win/Linux)或Cmd+Alt+Shift+P(macOS),状态栏必须输出source.python或source.ts;若显示text.plain或source.python.django,配置里的scopes就得写全 -
syntaxes必须是 Sublime 4+ 默认路径:Packages/Python/Python.sublime-syntax,不是旧版的.tmLanguage - 打开控制台(
Ctrl+`),搜索LSP或error,重点看有没有Failed to start server或spawn ENOENT
command 字段填错,LSP 就是哑巴
command 不是“写个名字就行”,它必须是终端里能直接运行的完整命令数组。写错路径、漏后缀、没进 PATH,都会导致静默失败,且无报错提示。
- Windows 用户注意:
tsserver必须带.cmd后缀,写成["tsserver"]会报spawn tsserver ENOENT;推荐用绝对路径:["C:/Users/xxx/AppData/Roaming/npm/tsserver.cmd"] - macOS/Linux 上用
which pyright或which pylsp取真实路径,填进command,例如:["/Users/you/.local/bin/pyright"] - 不要只写
["pyright"]就指望它自动找——Sublime 不读你的 shellPATH,尤其在 GUI 启动时 - 手动在终端运行一遍配置里的命令,比如
pyright --stdio,确认它不报错、不卡住、有输出
补全弹窗出来但 Tab 不确认、. 后没反应
这不是 LSP 配置问题,是 Sublime 自身补全行为被默认禁用或被其他插件劫持。
- 必须在用户设置(
Preferences → Settings右侧)加这两行:"auto_complete_commit_on_tab": true和"auto_complete": true;缺前者,Tab 永远只插缩进 -
auto_complete_triggers要显式声明,例如:[{"selector":"source.python","characters":"."}];selector必须和当前文件scope一致,不能写成text.python - 如果用了
AutoFileName或All Autocomplete,它们会覆盖 Tab 行为——临时禁用它们,测试是否冲突
最容易被忽略的是作用域(scope)和语法(syntax)的严格匹配:Sublime 不看文件后缀,只认当前文件实际绑定的 scope 和 syntax,而这两个值极易被 Anaconda、JSCustom 等插件覆盖或篡改。验证前先禁用所有非必要插件,再逐项排查。











