LSP插件需配对安装对应语言服务器才能启用功能;仅装LSP客户端无提示、跳转或参数弹窗,因缺少pyright等服务器,且须确认Package Control已安装、LSP配置中syntaxes与scopes匹配、enabled_languages启用对应语言。

LSP 插件本身不提供任何语言功能,必须配对安装对应语言服务器才能用——装完 LSP 后没提示、没跳转、没参数弹窗,不是插件坏了,是根本没装 pyright、typescript-language-server 或 clangd。
怎么确认 Package Control 和 LSP 都装对了
按 Ctrl+Shift+P(Win/Linux)或 Cmd+Shift+P(Mac)调出命令面板,输入 Package Control: Install Package:
- 能出现该命令 → Package Control 已就位
- 提示 “command not found” → 必须先手动安装 Package Control(粘贴官网 Python 安装代码到控制台执行)
再搜 LSP 并安装,注意作者必须是 sublimelsp;装完后重启 Sublime(部分系统不重启不加载)
为什么装了 LSP 却没有智能提示
常见错误现象:打开 .py 文件,状态栏没显示 LSP: ready,Ctrl+Click 跳转失败,Ctrl+Shift+Space 不弹参数框。原因通常是:
- pyright 或 python-lsp-server 没装,只装了 LSP 客户端
- 语言服务器不在系统 PATH 中,且配置里没写绝对路径
- syntaxes 字段写错,比如用了 Packages/Python/Python.tmLanguage(旧版),实际应为 Packages/Python/Python.sublime-syntax
- 没在用户设置中启用对应语言:"enabled_languages": ["python"] 缺失或拼错
如何正确配置 Python(以 pyright 为例)
推荐走 pip install pyright + 手动配置,比 LSP-pyright 插件更可控:
- 安装命令:pip install pyright(Windows 用户建议加 --user)
- 检查是否可用:pyright --version 在终端能输出版本号
- 打开 Preferences → Package Settings → LSP → Settings,右侧用户设置填:
{
"clients": {
"pyright": {
"command": ["pyright"],
"scopes": ["source.python"],
"syntaxes": ["Packages/Python/Python.sublime-syntax"],
"languageId": "python",
"enabled": true
}
}
}
- 保存后打开任意 .py 文件,右下角出现 LSP: pyright 即表示连通成功
调试时最该看的三件事
别一上来就重装:
- 打开 LSP: Toggle Log Panel(命令面板搜),看有没有 starting server 或 connection refused 类报错
- 用 Ctrl+Alt+Shift+P 查当前文件的 syntax 范围,确认和配置里的 scopes / syntaxes 完全匹配
- 对于 C/C++、Rust 等依赖构建信息的语言,compile_commands.json 或 rust-project.json 必须存在且路径被正确识别——LSP 不会自动猜项目根目录

















