LSP插件装完需手动配置语言服务器才能生效。先确认Package Control已安装,再通过命令面板安装LSP及对应封装插件(如LSP-pyright),最后在用户设置中启用语言、配置scopes/syntaxes/command,右下角显示“LSP: pyright”才表示连通成功。

装完 LSP 插件不等于 LSP 就能用——它默认一个语言服务器都不启,所有补全、跳转、悬停都静默失效。必须手动配置并确认服务真在跑。
确认 Package Control 已就位再动其他
没它,LSP 插件根本装不上。按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(macOS),输入 Package Control: Install Package 能弹出列表才算成功。如果报 command not found,就得手动装:
- 打开
View → Show Console - 粘贴官方安装脚本(含哈希校验),回车执行
- 重启 Sublime Text
LSP 插件和语言服务器必须分两步装
LSP 是通用客户端,只管通信;真正干活的是语言服务器(比如 pyright、typescript-language-server)。直接 npm 或 pip 装裸二进制,常因路径不可见而静默失败。
- 先装
LSP:命令面板搜Package Control: Install Package→LSP(作者sublimelsp) - 再装封装好的语言服务器插件,比如
LSP-pyright(Python)、LSP-typescript(TS/JS)——它们自带下载逻辑和默认command配置,省去手动找路径的麻烦 - 别同时启用
Anaconda和LSP-pyright:两者抢补全通道,会导致签名不显示、CPU 占用飙升
关键配置项必须手动加进用户设置
装完插件 ≠ 自动生效。LSP 默认禁用全部语言,也不展示参数文档。必须显式启用,并配对 scopes、syntaxes 和 command。
- 打开
Preferences → Package Settings → LSP → Settings - 在右侧用户设置中加入对应语言配置段,例如 Python:
{ "enabled_languages": ["python"], "clients": { "pyright": { "command": ["/usr/local/bin/pyright", "--stdio"], "scopes": ["source.python"], "syntaxes": ["Packages/Python/Python.sublime-syntax"] } } } -
command必须指向真实可执行文件,且含--stdio;Windows 下路径反斜杠要双写或用正斜杠,否则解析失败 - 右下角出现
LSP: pyright才算连通;若只显示LSP: ready或无反应,说明服务器根本没启动
验证是否真在运行:三处必查
补全没反应?不是插件坏了,是后端没起来。重点看这三处:
- 按
Ctrl+Alt+Shift+P(Win/Linux)或Cmd+Alt+Shift+P(macOS):状态栏输出必须是source.python这类有效 scope,不是text.plain - 打开控制台(
Ctrl+`),搜LSP或error:留意Failed to start server: exit code 1或spawn pyright ENOENT - 把配置里的
command数组完整复制到终端执行(如pyright --stdio):报command not found就得补 PATH 或改用绝对路径
项目结构影响比想象中大:单个打开 .py 文件,没有 pyproject.toml 或 package.json,很多服务器会降级运行甚至拒绝加载 AST —— 这类细节不报错,但功能直接打折。


















