WSL下VSCode+pipenv+pyenv非系统Python版本调试器无法工作

问题根因 #

这个报错本质是VSCode的Python扩展没法正确解析pyenv shim对应的非系统Python路径，自动推导pipenv虚拟环境解释器的时候匹配错了路径，调试器启动时加载了不匹配的Python二进制文件，才会触发报错。用系统原生Python创建环境时路径在标准位置，扩展能直接识别，所以不会出问题。

解决步骤 #

• 第一步：获取虚拟环境真实解释器路径
  进入项目根目录，执行命令拿到虚拟环境内Python解释器的绝对路径，不要使用pyenv的shim软链路径：

  pipenv --py
  

  典型输出格式：/home/你的用户名/.local/share/virtualenvs/项目名-随机字符串/bin/python
• 第二步：手动指定VSCode解释器
  按Ctrl+Shift+P调出命令面板，搜索执行Python: Select Interpreter，不要选择列表自动识别的pyenv/pipenv关联项，选择Enter interpreter path，粘贴上一步拿到的绝对路径确认选择。
• 第三步：修正调试配置
  在项目的.vscode/launch.json对应调试配置中，显式指定解释器路径，避免调试时自动推导错误，修正后的配置参考：

  {
      "version": "0.2.0",
      "configurations": [
          {
              "name": "Python: Current File",
              "type": "python",
              "request": "launch",
              "program": "${file}",
              "console": "integratedTerminal",
              "justMyCode": true,
              "python": "${command:python.interpreterPath}"
          }
      ]
  }
  

• 第四步：环境变量校验（以上步骤无效时操作）
  检查你使用的shell配置文件（.bashrc/.zshrc），确认pyenv初始化配置放在文件末尾，保证pyenv路径优先级高于系统Python路径，配置内容如下：

  export PYENV_ROOT="$HOME/.pyenv"
  command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
  eval "$(pyenv init -)"
  

  修改完成后执行source ~/.bashrc（对应你实际使用的shell配置文件）重载配置，重启VSCode即可。
• 额外兼容处理
  你当前使用的2022.6.7版本pipenv存在虚拟环境路径上报的已知bug，若以上步骤操作后仍有问题，执行pip install --upgrade pipenv升级到最新版后重建虚拟环境即可；如果是WSL环境，确认Python扩展安装在WSL远程侧，不要使用Windows侧的扩展跨环境调用。

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