LSP报“spawn ENOENT”或“command not found”是因Sublime的PATH与终端不一致,导致找不到pyright等二进制文件;需检查并补全PATH、修正Windows路径写法、避免command冲突、确保项目根目录存在对应配置文件。

为什么LSP总报“spawn ENOENT”或“command not found”
根本不是插件没装,而是Sublime启动语言服务器时根本找不到pyright、typescript-language-server或clangd这些二进制文件。Sublime的PATH和你终端里echo $PATH(Linux/macOS)或echo %PATH%(Windows)不一致,尤其在用nvm、pyenv、npm install -g或pipx安装工具时更明显。
验证方法:在Sublime控制台(Ctrl+`)运行import os; print(os.environ["PATH"]),对比终端输出。常见缺失路径包括:
-
~/.local/bin(Linux/macOS pipx 或 pip --user 安装位置) -
%USERPROFILE%AppDataRoaming pm(Windows npm -g 全局路径) -
/opt/homebrew/bin(Apple Silicon Mac Homebrew)
修复方式是在LSP用户设置中为对应语言加env字段,例如:
"pyright": {
"env": {
"PATH": "/home/you/.local/bin:" + os.environ["PATH"]
}
}
Windows下command路径写错导致服务器启动失败
Windows对路径分隔符和空格极其敏感。用单反斜杠写路径(如C:UsersJohn DoeAppDataRoaming
pmpyright.cmd)会被Python解释器当作转义字符处理,直接解析失败。
必须统一用正斜杠/或双反斜杠\,且含空格路径要确保命令能被Shell正确拆解。推荐写法:
"C:/Users/John Doe/AppData/Roaming/npm/pyright.cmd""C:\Users\John Doe\AppData\Roaming\npm\pyright.cmd"
别依赖相对路径——["pyright", "--stdio"]在Sublime里大概率失败,除非你100%确认全局PATH已生效且无环境隔离干扰。
多个语言服务器共存时command冲突
比如同时配了pyright和ruff-lsp,两者都设"selector": "source.python",LSP会按配置顺序加载,后者覆盖前者,结果只有ruff的诊断生效,pyright补全彻底消失。
解决办法不是删掉一个,而是错开作用域或显式分流:
- 让
ruff-lsp只响应source.python但禁用补全:"settings": {"server": {"enable": false}} - 给
pyright加更精确的scopes,比如["source.python", "source.python.django"](需配合语法高亮插件) - 用项目级
.sublime-project覆盖全局配置,避免跨项目干扰
检查是否生效:打开Python文件后按Ctrl+Alt+Shift+P看scope,再打开LSP日志面板(LSP: Toggle Log Panel),确认启动的是你期望的那个server。
pyright或typescript-language-server启动成功但功能残缺
看到右下角显示LSP: pyright≠功能可用。这类“假连接”最常因项目根目录缺失关键配置文件,导致服务器降级运行:
-
pyright:没pyrightconfig.json或pyproject.toml,它就当单文件处理,类型推导几乎失效 -
typescript-language-server:没tsconfig.json或node_modules/typescript,JSX、路径别名、declare module全挂 -
clangd:没compile_commands.json,连printf都不提示,因为它不知道你include了哪些头文件
注意:这些文件必须放在你用Sublime“以文件夹形式打开”的项目根目录下,而不是随便某个子目录。如果项目结构复杂,优先用compile_commands.json生成工具(如bear或CMake的-DCMAKE_EXPORT_COMPILE_COMMANDS=ON)生成,别手写。


















