必须先安装package control才能安装lsp插件,因其依赖该包管理器;安装后需重启sublime并验证命令列表;仅装lsp不够,还需配置对应语言服务器(如lsp-pyright);注意语法路径、windows路径格式、避免anaconda与lsp冲突,并确保项目级配置文件存在。

Sublime 必须先装 Package Control,否则 LSP 根本装不上
LSP 插件无法通过拖文件或双击安装,它依赖 Sublime 的包管理器——而 Sublime 默认不带 Package Control。没它,Ctrl+Shift+P 输入 Package Control: Install Package 会直接报 “command not found”,后面所有操作全卡死。
- 打开
View → Show Console,粘贴官网安装代码(含urllib.request和hashlib那段),回车执行 - 成功后必须重启 Sublime,否则 Package Control 不生效
- 验证方式:再按
Ctrl+Shift+P,输入Package Control:,能下拉出完整命令列表才算到位
只装 LSP 插件不行,还得配对应语言的 server
LSP 本身只是个通信中转站,真正干活的是后端语言服务器(比如 pyright、clangd、typescript-language-server)。装完 LSP 主插件后,如果你打开 .py 文件却没补全、没跳转、悬停也没参数提示——八成是 server 没就位。
- 推荐优先用
Package Control安装封装好的语言包,例如LSP-pyright(Python)、LSP-clangd(C/C++)、LSP-typescript(TS/JS)——它们自带下载逻辑和默认配置,省去路径折腾 - 如果手动配,比如用
pip install pyright,那必须确保pyright-langserver在系统PATH中;否则"command": ["pyright-langserver", "--stdio"]会静默失败 - Windows 用户特别注意:
command里路径别用单反斜杠,要么用正斜杠/,要么用双反斜杠\,否则 JSON 解析直接报错
配置里 scopes 和 syntaxes 错一个,LSP 就不认你的文件
即使 server 进程跑起来了,如果 scopes 写成 source.python,但你当前文件实际语法是 Packages/Python/Python.sublime-syntax(正确),而你配成了 Packages/Python/Python.tmLanguage(旧版废弃路径),LSP 就不会启动服务——状态栏也不显示 LSP,日志里也查不到连接记录。
- 快速确认当前文件真实语法:按
Ctrl+Alt+Shift+P(Windows/Linux)或Cmd+Alt+Shift+P(macOS),看底部面板输出的 scope 字符串 - 常见匹配项:
source.python对应Packages/Python/Python.sublime-syntax;source.c++对应Packages/C++/C++.sublime-syntax - 多个语法要支持?比如同时写
.cpp和.cc,就把"syntaxes"写成数组:["Packages/C++/C++.sublime-syntax", "Packages/C++/C.sublime-syntax"]
Python 用户特别小心:Anaconda 和 LSP 插件会互相打架
Sublime Text 4 自带 LSP 支持,再加上你手动装了 LSP-pyright 或 LSP-pylsp,又同时启用了老牌插件 Anaconda——三者会争抢 Python 补全通道,结果就是函数签名不弹、Go to Definition 失效、CPU 占用飙到 100%。
- 检查是否冲突:菜单
Preferences → Package Settings里如果同时存在Anaconda和LSP两项,基本就是问题源头 - 二选一更稳:
Anaconda配置简单、对虚拟环境友好;LSP + pyright类型推导更强、支持 PEP 604 等新特性——但别共存 - 禁用方法:菜单
Preferences → Package Control → Disable Package,选中LSP或Anaconda即可,不用卸载
最常被忽略的其实是 compile_commands.json(C/C++)、graphql.config.yml(GraphQL)、或者 pyproject.toml 里 [tool.pyright] 的存在——LSP 不只看配置文件,更依赖项目级元数据。server 启动了,不代表它“懂”你的项目结构。










