需先安装package control,再通过它安装sublimelsp官方lsp插件;装好后须单独安装对应语言服务器(如pylsp、gopls),并正确配置路径与syntax范围,最后通过lsp: toggle log panel查日志排错。

怎么装LSP插件?别跳过Package Control检查
Sublime Text 默认不带 LSP 支持,必须通过 Package Control 安装官方 LSP 插件(作者是 sublimelsp),不是 LSP-complete 或其他旧版变体。如果之前没装过 Package Control,它不会自动存在——得先手动装好,否则后续所有操作都无效。
- 按
Ctrl+Shift+P(Win/Linux)或Cmd+Shift+P(Mac)调出命令面板 - 输入
Install Package,回车后等几秒——若提示“no packages available”,说明Package Control没装或失效,需重装 - 搜索
LSP,选中安装;完成后重启 Sublime(部分系统需重启才加载成功)
装完就生效?不,LSP 插件本身不带任何语言服务器
装上 LSP 只是搭好了“桥梁”,真正干活的是外部语言服务器(如 pylsp、gopls、typescript-language-server)。它们得单独安装、确保可执行,并在配置里对得上路径和语法范围。
-
pip install python-lsp-server[all]或npm install -g pyright这类命令必须在终端成功运行,且生成的可执行文件在系统PATH中(用which pylsp或where gopls验证) - 如果服务器不在
PATH,配置里的"command"必须写绝对路径,比如["/Users/you/go/bin/gopls"],不能只写["gopls"] - 配置位置是:
Preferences → Package Settings → LSP → Settings,右侧用户设置里填"clients"对象,不是覆盖整个文件
为什么 .py 文件打开没提示?大概率 syntax 或 scope 错了
Sublime 判断该不该启动某个语言服务器,靠的是当前文件的 syntax(语法定义)和 scopes(作用域)。哪怕你装了 pylsp、写了配置,只要文件没被识别为 Python,LSP 就完全静默。
- 打开一个
.py文件,按Ctrl+Alt+Shift+P(Win/Linux)或Cmd+Alt+Shift+P(Mac),看状态栏显示是不是source.python——如果不是,说明语法没绑定对 -
"syntaxes"字段必须匹配实际路径,常见错误是写成Packages/Python/Python.tmLanguage(旧版),而 Sublime 4+ 默认用Packages/Python/Python.sublime-syntax - 如果用的是第三方 Python 插件(如 Anaconda),可能覆盖了原生语法,导致
scopes不一致,建议禁用冲突插件再试
启用后没反应?先看日志,别急着重启
功能不生效时,最直接的线索在 LSP 日志里。它会明确告诉你:服务器进程是否启动、stderr 报什么错、有没有收到初始化请求——比瞎猜快得多。
- 调出命令面板,输入
LSP: Toggle Log Panel,日志窗口会浮在底部 - 打开对应文件(如
index.ts),观察日志里是否出现starting typescript-language-server和后续的initialized;如果卡在spawn ENOENT,就是command路径错了 - 改完配置后不用重启 Sublime,用
LSP: Restart Servers即可重载,但前提是配置 JSON 语法正确(少个逗号都会让整个clients失效)











