Pyright 在 Sublime Text 中需手动配置可执行路径才能正常工作：必须通过 npm 全局安装 pyright，用 which/where 获取绝对路径填入 LSP-pyright 的 command 数组，并正确设置 pythonPath 指向虚拟环境解释器，同时禁用 Anaconda 等冲突插件。
想在 Sublime Text 中实现精准的 Python 类型检查和流畅的代码导航？Pyright 无疑是理想选择。然而，许多开发者在安装 LSP-pyright 插件后，发现其无法正常运行。问题的根源在于：该插件本身并不包含语言服务器，您需要手动指定 pyright 这个“核心引擎”的安装位置。换言之，您必须配置一个通过 npm 全局安装的 pyright CLI 可执行文件的具体路径。
确认 pyright CLI 已全局安装并可用
首先需要明确，Sublime Text 的 LSP 插件仅作为“客户端”或“调度器”，它不会自动安装 pyright 语言服务器。因此，首要步骤是确保 pyright 命令行工具已在您的系统中正确安装且全局可调用。请打开终端或命令提示符，输入以下命令进行验证：
pyright --version
如果系统返回 command not found 或类似错误，则表明 pyright 未安装或其路径未添加到系统的 PATH 环境变量中。最可靠的解决方案是通过 npm 进行全局安装（请确保已预先安装 Node.js）：
- 执行安装命令：
npm install -g pyright - 安装完成后，再次运行
pyright --version，确认能输出类似pyright 1.1.349的版本信息。 - 接下来是关键操作：使用
which pyright（macOS/Linux）或where pyright（Windows）命令，获取并记录其返回的完整绝对路径。例如，在 macOS 上结果可能为/usr/local/bin/pyright。此路径将在后续配置中用到。
在 LSP-pyright 设置中正确配置 command 路径
现在，启动 Sublime Text，依次进入 Preferences → Package Settings → LSP → Servers → LSP-pyright，编辑用户配置文件。配置的核心在于 command 字段，它必须是一个包含 pyright 绝对路径的数组。一个正确的配置示例如下：
立即学习“Python免费学习笔记（深入）”；
{
"command": ["/usr/local/bin/pyright", "--stdio"],
"enabled": true,
"initializationOptions": {
"typeshedPath": ""
}
}
配置过程中，请注意避开以下几个常见陷阱：
- 仅填写
["pyright", "--stdio"]：这是最常见的错误。LSP 客户端将因找不到命令而启动失败，查看日志通常会看到spawn pyright ENOENT这类错误信息。 - 路径包含空格但未加引号（Windows 用户需特别注意）：例如
C:UsersMy NameAppDataRoamingpmpyright.cmd这样的路径，必须用双引号包裹整个路径字符串。 - 路径分隔符使用混乱：在 Windows 系统上，建议统一使用正斜杠或双反斜杠，例如
"C:/Users/Name/AppData/Roaming/npm/pyright.cmd"或"C:\Users\Name\AppData\Roaming\npm\pyright.cmd"，以避免解析错误。
配置 Python 解释器路径以提升类型推断准确性
即使 pyright 语言服务器成功启动，您仍可能遇到“无法解析导入”或类型提示不全的问题。这通常是因为 pyright 默认使用了系统 Python 解释器，而您的项目实际运行在特定的虚拟环境（如 venv 或 conda）中。解决方案是明确告知 pyright 应使用哪个解释器。
主要有两种配置方式：
- 项目级配置：在项目根目录下创建一个名为
.pyrightconfig.json的配置文件。对于 macOS/Linux 系统，参考内容如下：{"pythonVersion": "3.11", "pythonPath": "./venv/bin/python"}对于 Windows 系统，则应为：{"pythonVersion": "3.11", "pythonPath": ".\venv\Scripts\python.exe"} - 全局设置：在之前编辑的 LSP-pyright 用户配置文件中，增加一个
settings字段："settings": { "python.environment": { "pythonPath": "/path/to/your/venv/bin/python" } }
请注意一个关键细节：pythonPath 必须指向虚拟环境内具体的 Python 解释器可执行文件（如 python.exe 或 python），而不是虚拟环境的根目录文件夹。
禁用其他 Python 插件以避免功能冲突
最后一个影响使用体验的因素是插件冲突。Sublime Text 生态中存在一些历史遗留的 Python 智能提示插件，例如 Anaconda、SublimeCodeIntel 或基于旧版 Jedi 的插件。如果它们与 LSP-pyright 同时启用，极易导致代码跳转错乱、重复的悬停提示，甚至引起 CPU 占用率异常升高。需要了解的是，LSP-pyright 是基于现代 Language Server Protocol 标准构建的解决方案，并且是目前维护最活跃的 Python 语言服务器插件，其他同类插件通常可以安全禁用。
操作步骤如下：
- 通过 Preferences → Package Control → Disable Package 打开插件禁用管理界面。
- 在列表中查找并禁用诸如
Anaconda、SublimeCodeIntel、Jedi、Python IDE等涉及 Python 代码智能感知的插件。 - 完成后重启 Sublime Text。观察编辑器状态栏，理想情况下应仅显示
LSP: pyright标识，而非多个提示图标并存。
总而言之，pyright 的响应速度与类型推断精度，很大程度上取决于前述路径配置的准确性，而非安装插件的数量。有时，多启用一个旧版插件，反而可能导致代码跳转定位到库的存根文件而非您自己的源代码，结果适得其反。
