Pyright无法识别Pyenv虚拟环境Python解释器问题求助

核心问题 #

Pyenv切换Python版本（pyenv shell/pyenv activate）后，Neovim中的Pyright LSP未同步识别对应环境，导致Python2语法（如print a）仍报错。

可能原因 #

1. Neovim未继承Pyenv环境变量：若从GUI（如Spotlight、Finder）启动Neovim，进程不会加载shell配置文件（.zshrc/.bashrc），导致Pyenv的shims路径未被正确纳入Neovim的$PATH，Pyright无法找到当前激活的Python版本。
2. Pyright环境缓存未更新：Pyright启动时会缓存Python环境信息，切换版本后未重启LSP则不会读取新环境。
3. 默认配置未指定Python路径：Pyright默认可能优先找到系统全局Python，而非Pyenv管理的版本。

解决步骤 #

1. 确保Neovim继承Pyenv环境 #

• 优先从终端启动Neovim：直接在终端执行nvim打开文件，此时Neovim会继承终端已激活的Pyenv环境变量。
• 若需GUI启动：修改Neovim的启动配置，让其加载shell配置文件（比如Mac上通过iTerm启动Neovim，或给Neovim.app添加启动脚本加载.zshrc）。

2. 配置Pyright指定Python路径 #

修改Pyright的LSP配置，强制让其使用当前Pyenv环境的Python：

local lspconfig = require("lspconfig")
lspconfig.pyright.setup({
  settings = {
    python = {
      -- 自动获取当前环境的python路径（依赖Neovim继承Pyenv环境）
      pythonPath = vim.fn.exepath("python"),
      -- 也可手动指定虚拟环境的python路径，比如：
      -- pythonPath = "/Users/xxxx/.pyenv/versions/my-python2/bin/python"
    }
  }
})

3. 切换环境后重启Pyright #

每次用pyenv shell或pyenv activate切换版本后，在Neovim中执行：

:LspRestart pyright

让Pyright重新读取当前环境的Python版本与语法规则。

4. 验证环境有效性 #

在Neovim中执行:!python --version，检查输出版本是否与当前Pyenv激活的版本一致：

• 若不一致：说明Neovim未继承Pyenv环境，回到步骤1解决。
• 若一致但仍报错：执行步骤3重启LSP，或删除项目根目录的.pyrightconfig.json清除缓存后重试。

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