已安装Python语言服务器但Helix文本编辑器无法检测到的问题

问题描述 #

我正在使用Helix文本编辑器，尝试添加Python语言服务器。通过官网的.exe安装Python 3后，执行以下命令安装成功：

C:\Users\ZIGLA> pip config set global.trusted-host "pypi.org files.pythonhosted.org pypi.python.org"
C:\Users\ZIGLA> pip install pip-system-certs
C:\Users\ZIGLA> python.exe -m pip install python-lsp-server

但运行pylsp命令时系统提示找不到，Helix健康检查也无法检测到它：

C:\Users\ZIGLA> hx --health

# 省略其他输出...
Language            LSP                 DAP                 Highlight           Textobject          Indent

...

python              ✘ pylsp             None                ✓                   ✓                   ✓

...

已尝试的排查步骤 #

• 查看pip安装位置，确认python-lsp-server安装在C:\Users\ZIGLA\AppData\Roaming\Python\Python311\site-packages
• 检查该目录下的pylsp子文件夹，发现只有Python模块文件，没有可执行文件
• 将C:\Users\ZIGLA\AppData\Roaming\Python\Python311\site-packages\pylsp添加到系统PATH，但问题依旧

解决方案 #

方法1：添加pip脚本目录到PATH #

pip安装Python包时，会将可执行脚本（比如pylsp.exe）放在Scripts目录下，用户安装模式下这个路径是C:\Users\ZIGLA\AppData\Roaming\Python\Python311\Scripts。你之前错误添加了模块目录，正确操作：

1. 打开PowerShell配置文件：

hx $PROFILE

2. 修改PATH配置为：

$ENV:PATH += ";C:\Users\ZIGLA\AppData\Roaming\Python\Python311\Scripts"

3. 重启终端，执行pylsp --version验证命令是否可用
4. 再次运行hx --health检查Helix是否能检测到pylsp

方法2：直接配置Helix使用Python模块启动 #

如果不想修改PATH，可以直接在Helix的语言配置里指定通过Python模块启动pylsp：

1. 打开Helix的languages.toml文件：

hx C:\Users\ZIGLA\AppData\Roaming\helix\languages.toml

2. 找到Python相关配置，修改language-server项：

[[language]]
name = "python"
language-server = { command = "python", args = ["-m", "pylsp"] }
# 保留其他原有配置...

3. 保存后重启Helix，再次运行hx --health验证

注意事项 #

你系统中同时存在Python311和Python312，要确保使用安装了python-lsp-server的Python311版本。如果python命令默认指向312，需要替换为python3.11或者完整路径C:\Program Files\Python311\python.exe

内容的提问来源于stack exchange，提问作者71GA