必须先安装package control,否则lsp插件及语言服务器均无法安装;接着通过package control安装lsp插件(作者sublimelsp)和对应语言服务器(如lsp-pyright),再手动执行“lsp: enable language server globally”启用服务,并严格配置command、scopes、syntaxes三项参数,最后验证右下角状态与lsp日志确认生效。

Sublime Text没装Package Control就别碰LSP
所有后续操作都依赖它,没它连 LSP 插件都装不上。按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control: Install Package 能弹出菜单才算成功;如果提示 “command not found”,说明还没装。
手动安装只需一次:打开 View → Show Console,粘贴官方安装脚本回车执行,然后重启 Sublime。跳过这步,后面装的 LSP、LSP-pyright 全部会静默失败。
LSP插件和语言服务器必须分两步装
LSP 插件只是通信层,不干活;真正解析语法、推导类型、提供补全的是语言服务器(比如 pyright、typescript-language-server)。只装插件不装服务器,等于买了路由器但没接网线。
- 用
Ctrl+Shift+P→Package Control: Install Package装LSP(作者sublimelsp) - 再搜
LSP-pyright(Python 推荐)或LSP-typescript(JS/TS),它们自带下载逻辑和默认路径,比裸装npm install -g typescript-language-server更稳 - 装完后必须手动执行
LSP: Enable Language Server Globally,勾选对应服务器——这步不做,右下角永远显示Plain Text
LSP-pyright 和旧插件 Anaconda 不能共存,会抢补全通道,导致 CPU 飙升、签名不显示,冲突时直接禁用 Anaconda。
配置里最容易错的三个字段
在 Preferences → Package Settings → LSP → Settings 右侧用户设置中填 "clients" 对象,以下三项必须严丝合缝:
-
"command":数组形式,如["pylsp"]或["/Users/you/.local/bin/pyright-langserver", "--stdio"];Windows 注意双反斜杠或正斜杠,单反斜杠会解析失败 -
"scopes":必须和当前文件实际 scope 一致,打开.py文件后按Ctrl+Alt+Shift+P看状态栏,显示source.python才对;若显示source.python.django或其他变体,就得把 scope 写全 -
"syntaxes":Sublime 4+ 默认用Packages/Python/Python.sublime-syntax,不是旧版的.tmLanguage;如果用了Anaconda等第三方插件,可能覆盖原生语法,建议临时禁用再试
装完服务器后,务必验证可执行性:which pylsp(macOS/Linux)或 where pyright-langserver(Windows),失败就说明没进 PATH,配置里得写绝对路径。
启用后没反应?先看日志,别重启
功能静默时,最直接线索在 LSP 日志里:Preferences → Package Settings → LSP → Toggle Log Panel。它会清楚告诉你:
- 服务器进程是否成功启动(
spawned还是ENOENT) - 是否因找不到
svelte.config.js或tsconfig.json而提前退出(这类失败通常不报错,只静默终止) - scope 或 syntax 匹配失败的具体提示,比如 “no matching client for source.python.django”
日志里出现 starting 但没后续,大概率是服务器二进制不可执行或配置路径错误;出现 client stopped 紧接着 error,重点查 command 和项目根目录是否存在必需配置文件。











