如何无需关闭NVIM，刷新venv以识别新安装的Python模块？

问题场景 #

• TMUX分两个面板，均执行source env/bin/activate激活同一虚拟环境，主面板运行NVIM，副面板用作控制台
• 副面板通过pip install "x"安装新包后，NVIM中的Pyright会抛出错误："Import "x" could not be resolved"
• 仅:e刷新文件无法解决，必须重启NVIM才能让Pyright识别新包；:checkhealth显示虚拟环境已激活且PATH配置正确，相同配置在MacBook上可正常工作

环境信息 #

• OS：EndeavourOS
• 终端：Alacritty + TMUX
• Python LSP：pyright

已尝试无效操作 #

• 使用:e命令刷新当前文件
• 切换TMUX的synchronize-panes开关（setw synchronize-panes on/off）
• 执行:checkhealth检查环境配置
• 在NVIM内置:terminal中激活虚拟环境并刷新

解决方案 #

方法1：强制Pyright重启服务 #

在NVIM中执行以下命令，直接重启Pyright服务，让它重新扫描虚拟环境的依赖：

:LspRestart pyright

这个操作比重启NVIM快很多，能立即让Pyright识别新安装的包。

方法2：让Pyright自动监听依赖目录变化 #

修改NVIM的Pyright LSP配置，添加对虚拟环境site-packages目录的监听，这样新包安装后Pyright会自动更新：

require('lspconfig').pyright.setup({
  settings = {
    python = {
      analysis = {
        autoSearchPaths = true,
        diagnosticMode = "workspace",
      }
    },
    workspace = {
      didChangeWatchedFiles = {
        dynamicRegistration = true,
      }
    }
  }
})

注：如果用的是基于nvim-lspconfig的配置，这个设置直接生效，无需额外插件。

方法3：直接指定Pyright的Python解释器 #

避免终端环境变量同步的问题，在NVIM中直接指定虚拟环境的Python解释器路径：

:let g:python3_host_prog = getcwd() . '/env/bin/python'

或者写入LSP配置文件永久生效：

require('lspconfig').pyright.setup({
  settings = {
    python = {
      pythonPath = vim.fn.getcwd() .. '/env/bin/python',
    }
  }
})

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